Flickr API ドキュメント日本語訳 |
flickr.people.getGroups
ユーザーが所属しているグループの一覧を取得します。
認証
このメソッドには「読み込み」権限の認証が必要です。
引数
api_key
(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
user_id
(Required)- 取得するグループに所属しているユーザーのNSID。
extras
(Optional)- 追加で取得したい情報があれば、その情報が保存されているフィールドをコンマ区切りで設定します。現時点では、以下のフィールドをサポートしています:
privacy
,throttle
,restrictions
サーバからの応答例
<groups> <group nsid="17274427@N00" name="Cream of the Crop - Please read the rules" iconfarm="1" iconserver="1" admin="0" eighteenplus="0" invitation_only="0" members="11935" pool_count="12522" /> <group nsid="20083316@N00" name="Apple" iconfarm="1" iconserver="1" admin="0" eighteenplus="0" invitation_only="0" members="11776" pool_count="62438" /> <group nsid="34427469792@N01" name="FlickrCentral" iconfarm="1" iconserver="1" admin="0" eighteenplus="0" invitation_only="0" members="168055" pool_count="5280930" /> <group nsid="37718678610@N01" name="Typography and Lettering" iconfarm="1" iconserver="1" admin="0" eighteenplus="0" invitation_only="0" members="17318" pool_count="130169" /> </groups>
admin属性はそのユーザーがグループの管理者かどうかを表します。eighteenplus属性はそのグループの参加要件が18歳以上限定になっているかどうかを表します。 invite_only属性はそのグループに管理者の承認なしで参加できるかどうかを表します。
エラーコード
1: User not found
- 指定されたユーザーIDはFlickrのユーザーに合致しませんでした。
95: SSL is required
- Flickr APIにはSSLでの接続が必要です。
96: Invalid signature
- 送信された署名は無効です。
97: Missing signature
- 実行には署名が必要ですが、署名が送信されていませんでした。
98: Login failed / Invalid auth token
- 送信されたログイン情報や認証トークンが無効です。
99: User not logged in / Insufficient permissions
- このメソッドの実行にはユーザー認証が必要ですが、ユーザがログインしていないか、認証メソッドを実行するのに必要な権限がありません。
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.getGroups
注意事項 |