Flickr API ドキュメント日本語訳 |
flickr.stats.getPhotoDomains
写真にリンクを貼っているドメインの一覧を取得します。
認証
このメソッドには「読み込み」権限の認証が必要です。
引数
api_key(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
date(Required)- この日付の統計を取得します。これはYYYY-MM-DD形式かunixタイムスタンプ形式 のどちらかにしなければいけません。 統計は午前0時(GMT)に開始され、設定した日付についてはその開始時間になるよう自動的に切り捨てが行われます。
photo_id(Optional)- 統計を取得する写真のID。設定されなかった場合、全ての写真の統計が取得されます。
per_page(Optional)- 1ページ当たりに出力するドメインの数。この引数を省略した場合、既定では25が設定されます。設定できる最大値は100です。
page(Optional)- 出力するページのページ番号。この引数が省略された場合、既定では1が設定されます。
サーバからの応答例
<domains page="1" perpage="25" pages="1" total="3"> <domain name="images.search.yahoo.com" views="127" /> <domain name="flickr.com" views="122" /> <domain name="images.google.com" views="70" /> </domains>
一つのリンク元ドメインにつき、ドメイン名や閲覧数を表す属性を持った<domain> elementが一つ存在します。
各ドメインからのリンク元の詳細については、flickr.stats.getPhotoReferrersメソッドを実行して確認できます。
エラーコード
1: User does not have stats- 指定したユーザーは、自分のアカウントに関する統計を有効にしていません。
2: No stats for that date- 指定した日付では使用できる統計がありません。Flickrは最新28日間のみの統計データしか保存していません。
3: Invalid date- 指定された日付を識別できませんでした。
4: Photo not found- コレクションIDは有効でないか、もしくはメソッド実行ユーザーのコレクションではありません。
95: SSL is required- Flickr APIにはSSLでの接続が必要です。
96: Invalid signature- 送信された署名は無効です。
97: Missing signature- 実行には署名が必要ですが、署名が送信されていませんでした。
98: Login failed / Invalid auth token- 送信されたログイン情報や認証トークンが無効です。
99: User not logged in / Insufficient permissions- このメソッドの実行にはユーザー認証が必要ですが、ユーザがログインしていないか、認証メソッドを実行するのに必要な権限がありません。
100: Invalid API Key- 送信されたAPIキーは無効か、既に失効しています。
105: Service currently unavailable- 要求されたサービスは、一時的に利用できない状態です。
106: Write operation failed- 要求された操作は、一時的な問題のために失敗しました。
111: Format "xxx" not found- 要求された応答形式は見つかりませんでした。
112: Method "xxx" not found- 要求されたメソッドは見つかりませんでした。
114: Invalid SOAP envelope- リクエスト時に送信されたSOAPエンベロープを解析できませんでした。
115: Invalid XML-RPC Method Call- リクエスト時に送信されたXML-RPC ドキュメントを解析できませんでした。
116: Bad URL found- 引数の中に、Flickrに対して有害なURLが含まれています。
API 体験
API 体験 : flickr.stats.getPhotoDomains
注意事項 |