flickr.photosets.getList

指定したユーザーが所有する写真集を取得します。

認証

このメソッドには認証は必要ありません。

引数

api_key (Required)
あなたのAPIアプリケーションキー。詳細についてはここを参照してください
user_id (Optional)
写真集一覧を取得するユーザーのNSID。この値が設定されていなかった場合、メソッド実行ユーザーの写真集が取得されます。
page (Optional)
取得する出力結果ページ。現在、この値が設定されていなかった場合は全ての写真集が出力されますが、この動作は将来変更される可能性があります。
per_page (Optional)
1ページ当たりに出力する写真集の数。ページング設定が有効になっている場合、設定できる最大値は500です。
primary_photo_extras (Optional)
追加で取得したい情報があれば、その情報が保存されているフィールドをコンマ区切りで設定します。現時点では、以下のフィールドをサポートしています: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_m, url_o

サーバからの応答例

<photosets page="1" pages="1" perpage="30" total="2" cancreate="1">
  <photoset id="72157626216528324" primary="5504567858" secret="017804c585" server="5174" farm="6" photos="22" videos="0" count_views="137" count_comments="0" can_comment="1" date_create="1299514498" date_update="1300335009">
    <title>Avis Blanche</title>
    <description>My Grandma's Recipe File.</description>
  </photoset>
  <photoset id="72157624618609504" primary="4847770787" secret="6abd09a292" server="4153" farm="5" photos="43" videos="12" count_views="523" count_comments="1" can_comment="1" date_create="1280530593" date_update="1308091378">
    <title>Mah Kittehs</title>
    <description>Sixty and Niner. Born on the 3rd of May, 2010, or thereabouts. Came to my place on Thursday, July 29, 2010.</description>
  </photoset>
</photosets>

写真集は、その所有者が設定した並び順通りに取得されます。新着順に表示されるわけではありません。アプリケーションで写真集を表示する際には、その所有者が設定した並び順を尊重してください。

エラーコード

1: User not found
設定されたユーザーIDは有効なユーザーNSIDでなく、メソッド実行ユーザはログインしていません。
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.photosets.getList



注意事項

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