flickr.stats.getPopularPhotos

閲覧数、コメント数、お気に入り登録数のうちいずれかが最も多い写真の一覧

認証

このメソッドには「読み込み」権限の認証が必要です。

引数

api_key (Required)
あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
date (Optional)
この日付の統計を取得します。これはYYYY-MM-DD形式かunixタイムスタンプ形式 のどちらかにしなければいけません。 統計は午前0時(GMT)に開始され、設定した日付についてはその開始時間になるよう自動的に切り捨てが行われます。 この日付が設定されない場合、全ての期間の閲覧数が取得されます。
sort (Optional)
取得する写真の並び順。既定では viewsが設定されます。設定可能な値は views(閲覧数順)と comments(コメント数順) と favorites(お気に入り登録数順)です。 その他の並び順オプションについては、flickr.photos.searchのページを参照してください。
per_page (Optional)
1ページ当たりに出力するリンク元の数。この引数を省略した場合、既定では25が設定されます。設定できる最大値は100です。
page (Optional)
出力するページのページ番号。この引数が省略された場合、既定では1が設定されます。

サーバからの応答例

<photos page="2" pages="89" perpage="10" total="881">
  <photo id="2636" owner="47058503995@N01" secret="a123456" server="2" title="test_04" ispublic="1" isfriend="0" isfamily="0">
    <stats views="941" comments="18" favorites="2" />
  </photo>
  <photo id="2635" owner="47058503995@N01" secret="b123456" server="2" title="test_03" ispublic="0" isfriend="1" isfamily="1">
    <stats views="141" comments="1" favorites="2" />
  </photo>
</photos>

このメソッドは標準的なxml形式の写真一覧を返します。

加えて各photoエレメントは<stats>エレメントを保持しています。<stats>エレメントは指定した日付の閲覧数、コメント数、お気に入り登録数を表す属性を持っています。

<photo>エレメントからそのURLを割り出す方法については、 url ドキュメントを参照してください。

エラーコード

1: User does not have stats
指定したユーザーは、自分のアカウントに関する統計を有効にしていません。
2: No stats for that date
指定した日付では使用できる統計がありません。Flickrは最新28日間のみの統計データしか保存していません。
3: Invalid date
指定された日付を識別できませんでした。
5: Invalid domain
想定外の形式のドメインが設定されました。
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.getPopularPhotos



注意事項

  • 本サイトはflickrのサイトを翻訳したものであり、flickrに関する著作権は全てそちらに帰属しています。
  • 誤訳が判明した場合、より分かりやすい言い回しが見つかった場合、原文が変更された場合などにより、本サイトの内容は予告なく変更されることがあります。
  • 誤訳についての指摘や未翻訳部分についての助言など、ご意見についてはこちらへいただけると助かります。
  • 翻訳の内容には誤りがある可能性があります。本サイトの記述内容によって不利益が発生した場合も、サイト管理人は一切の責任を負いません。
    •