Flickr API ドキュメント日本語訳 |
flickr.collections.getTree
指定したユーザーが所有するツリー構造のコレクション一覧(もしくはツリー構造内部のコレクション)を戻り値として返します。
認証
このメソッドには認証は必要ありません。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
collection_id
(Optional)- ツリー構造内の抽出対象とするコレクションのID。0を設定するとツリー構造の最上部にあるコレクションを抽出します。既定では0が設定されます。
user_id
(Optional)- コレクション一覧を取得するユーザーのアカウントID。既定ではメソッドを実行したユーザーのコレクション一覧を取得します。
サーバからの応答例
<collections> <collection id="12-72157594586579649" title="All My Photos" description="a collection" iconlarge="http://farm1.static.flickr.com/187/cols/37_43fac2cf79_l.jpg" iconsmall="http://farm1.static.flickr.com/187/cols/56_43fac2cf79_s.jpg"> <set id="92157594171298291" title="kitesurfing" description="a set" /> <set id="72157594247596158" title="faves" description="some favorites." /> </collection> </collections>collectionsエレメントの内部がツリー構造となっています。collectionsエレメントとその内部に格納された情報です。
エラーコード
1: User not found
- 指定されたユーザは見つかりませんでした。
2: Collection 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.collections.getTree
注意事項 |