Flickr API ドキュメント日本語訳 |
flickr.photosets.getPhotos
写真集の中の写真一覧を取得します。
認証
このメソッドには認証は必要ありません。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
photoset_id
(Required)- 写真を取得する写真集のID。
user_id
(Required)- 指定する写真集の所有者であるユーザーのユーザーID。この値は任意で設定しますが、設定したほうがパフォーマンスが向上します。
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
per_page
(Optional)- 1ページ当たりに出力する写真数。この引数を省略した場合、既定では500が設定されます。設定できる最大値は500です。
page
(Optional)- 出力するページのページ番号。この引数が省略された場合、既定では1が設定されます。
privacy_filter
(Optional)- 指定された公開レベルに合致する写真のみを取得します。この設定は、あなた自身の写真セットに対して認証済みメソッドを実行した場合に適用されます。有効な値は以下の通りです:
- 1 公開写真
- 2 友達は見ることができる非公開写真
- 3 家族は見ることができる非公開写真
- 4 友達と家族は見ることができる非公開写真
- 5 完全な非公開写真
media
(Optional)- メディアタイプによって出力結果を絞り込みます。設定可能な値は
all
(既定値)、photos
、videos
です。
サーバからの応答例
<photoset id="4" primary="2483" page="1" perpage="500" pages="1" total="2"> <photo id="2484" secret="123456" server="1" title="my photo" isprimary="0" /> <photo id="2483" secret="123456" server="1" title="flickr rocks" isprimary="1" /> </photoset>
エラーコード
1: Photoset not found
- 設定された写真集IDは有効な写真集IDではありません。
2: User not found
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.getPhotos
注意事項 |