flickr.people.getPhotos

指定したユーザーのフォトストリームから写真を取得します。メソッド実行ユーザが参照できる写真のみが戻り値として返ります。 このメソッドは認証を受ける必要があります。 公開写真をユーザーへ送る際にflickr.people.getPublicPhotosを使用しています。

認証

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

引数

api_key (Required)
あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
user_id (Required)
写真を取得するユーザのNSID。"me"を設定するとメソッドを実行したユーザの写真が取得されます。
safe_search (Optional)
安全検索設定:
  • 1 は安全(safe)。
  • 2 は普通(moderate)。
  • 3 は制限付き(restricted)。
(注意してください:認証せずにメソッドを実行するとSafeコンテンツのみ参照できます。)
min_upload_date (Optional)
最も古いアップロード日時。この日時以降にアップロードされた写真のみが取得されます。日時はunixタイムスタンプ形式で設定してください。
max_upload_date (Optional)
最も新しいアップロード日時。この日時以前にアップロードされた写真のみが取得されます。日時はunixタイムスタンプ形式で設定してください。
min_taken_date (Optional)
最も古い撮影日時。この日時以降に撮影された写真のみが取得されます。日時は mysql の日時形式で設定してください。
max_taken_date (Optional)
最も新しい撮影日時。この日時以前に撮影された写真のみが取得されます。日時は mysql の日時形式で設定してください。
content_type (Optional)
コンテンツタイプの設定:
  • 1 は写真のみ。
  • 2 はスクリーンショットのみ。
  • 3 は'その他' のみ。
  • 4 は写真とスクリーンショット。
  • 5 はスクリーンショットと 'その他'.
  • 6 は写真と 'その他'.
  • 7 は写真とスクリーンショットと 'その他' (all).
privacy_filter (Optional)
指定した公開レベルに合致する写真のみを取得。この設定はあなた自身の写真を参照する場合に適用されます。使用できる値は以下の通り:
  • 1 公開写真
  • 2 友達であれば見ることができる非公開写真
  • 3 家族であれば見ることができる非公開写真
  • 4 友達か家族であれば見ることができる非公開写真
  • 5 完全な非公開写真
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が設定されます。

サーバからの応答例

このメソッドでは、標準的なxml形式の写真一覧を戻り値として返しますT:

<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" />
	<photo id="2635" owner="47058503995@N01"
		secret="b123456" server="2" title="test_03"
		ispublic="0" isfriend="1" isfamily="1" />
	<photo id="2633" owner="47058503995@N01"
		secret="c123456" server="2" title="test_01"
		ispublic="1" isfriend="0" isfamily="0" />
	<photo id="2610" owner="12037949754@N01"
		secret="d123456" server="2" title="00_tall"
		ispublic="1" isfriend="0" isfamily="0" />
</photos>

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

エラーコード

1: Required arguments missing
APIを実行するのに必要ないくつかのパラメータが設定されていません。
2: Unknown user
指定された user_id 引数は、有効なflickrユーザーに合致しませんでした。
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.people.getPhotos



注意事項

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