Flickr API ドキュメント日本語訳 |
flickr.photosets.editPhotos
写真集の写真を編集します。このメソッドを使うと、写真の追加・削除・整理がまとめてできます。
認証
このメソッドには「書き込み」権限の認証が必要です。
注意: このメソッドはHTTP POST リクエストを使用します。
引数
api_key(Required)- あなたのAPIアプリケーションキー。詳細についてはここを参照してください。
photoset_id(Required)- 編集する写真集のID。この写真集はメソッド実行ユーザが所有する写真集でなければなりません。
primary_photo_id(Required)- この写真集の'メイン'写真集として使う写真のID。このIDはphoto_ids引数の一覧にも含まれていなければなりません。
photo_ids(Required)- 写真集に設定する写真IDをコンマ区切りでまとめて一覧。設定された順番通りに写真集内で表示されます。この一覧にはメイン写真も含まれていなければなりません。 この写真一覧は既存の一覧に置き換えられます。写真集に写真を追加したい場合は、flickr.photosets.addPhotoを実行してください。
サーバからの応答例
このメソッドでは特別な応答はありません - エラーなしで完了した場合、空の成功応答が返ります。
エラーコード
1: Photoset not found- 設定された写真集IDは有効な写真集IDではない、もしくはメソッド実行ユーザーが所有する写真集ではありません。
2: Photo not found- 設定された写真IDのうちいくつかが有効ではありません、もしくはメソッド実行ユーザーが所有する写真ではありません。
3: Primary photo not found- 設定されたメイン写真IDは有効な写真IDではない、もしくはメソッド実行ユーザーが所有する写真ではありません。
4: Primary photo not in list- 設定されたメイン写真IDは、写真ID一覧の中に含まれていません。
5: Empty photos list- 写真ID一覧が設定されていません。
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.photosets.editPhotos
注意事項 |