Flickr API ドキュメント日本語訳 |
flickr.photos.people.add
写真に"人"を追加します。座標と背景領域のサイズを任意で設定できます。;
それらは各写真ページに表示される500pxの画像サイズを基にしたピクセル単位となります。
認証
このメソッドには「書き込み」権限の認証が必要です。
注意: このメソッドはHTTP POST リクエストを使用します。
引数
api_key(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
photo_id(Required)- "人"を追加する写真のID。
user_id(Required)- 写真に追加するユーザーのNSID。
person_x(Optional)- 背景領域の左端となるピクセル座標。
person_y(Optional)- 背景領域の最上部となるピクセル座標。
person_w(Optional)- 背景領域の横幅(ピクセル単位)。
person_h(Required)- 背景領域の縦幅(ピクセル単位)。
サーバからの応答例
このメソッドでは特別な応答はありません - エラーなしで完了した場合、空の成功応答が返ります。
エラーコード
1: Person not found- 設定されたNSIDは有効なユーザーIDではありません。
2: Photo not found- 設定された写真IDは有効な写真IDではありません。
3: User cannot add this person to photos- 写真に追加しようとした"人"は、このメソッド実行ユーザによって自分が写真に追加されることを許可していません。
4: User cannot add people to that photo- この写真の所有者は、メソッド実行ユーザーが自分の写真に"人"を追加することを許可していません。
5: Person can't be tagged in that photo- 写真に追加しようとした"人"は、この写真に追加されたくありません。
6: Some co-ordinate paramters were blank- 座標パラメータ(person_x, person_y, person_w, person_h)のうちのどれかに有効な値が設定されませんでした。
7: Can't add that person to a non-public photo- あなたは、他メンバーの非公開写真に対して自分だけしかついかできません。
8: Too many people in that photo- 既に写真に追加できる"人"の最大数まで追加されています。
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.photos.people.add
注意事項 |