Flickr API ドキュメント日本語訳 |
flickr.groups.pools.getPhotos
(アクセス権が設定されていた場合は)グループのアクセス権とユーザのログイン状況に基づき、指定したグループの共有写真の一覧を取得します。
認証
このメソッドには認証は必要ありません。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
group_id
(Required)- 共有写真の一覧を取得するグループのID。
tags
(Optional)- 共有写真をフィルターするためのタグ。現時点では一度に一つのタグ付けのみサポートしています。
user_id
(Optional)- ユーザーのNSID。このパラメータを設定することで、指定したユーザーグループの共有写真に追加した写真のみを取得することができます。
extras
(Optional)- 追加で取得したい情報があれば、その情報が保存されているフィールドをコンマ区切りで設定します。現時点では、以下のフィールドをサポートしています:
description
,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_q
,url_m
,url_n
,url_z
,url_c
,url_l
,url_o
per_page
(Optional)- 1ページ当たりに出力する写真数。この引数を省略した場合、既定では100が設定されます。設定できる最大値は500です。
page
(Optional)- 出力するページのページ番号。この引数が省略された場合、既定では1が設定されます。
サーバからの応答例
<photos page="1" pages="1" perpage="1" total="1"> <photo id="2645" owner="12037949754@N01" title="36679_o" secret="a9f4a06091" server="2" ispublic="1" isfriend="0" isfamily="0" ownername="Bees / ?" dateadded="1089918707" /> </photos>
エラーコード
1: Group not found
- 指定されたグループIDは有効なグループIDではありません。
2: You don't have permission to view this pool
- (もし許可制限があれば)ログインしているユーザーは、このグループの共有写真を参照する権限がありません。
3: Unknown user
- 指定されたuser_id引数のユーザーは存在しません。
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.groups.pools.getPhotos
注意事項 |