Method: albums.batchAddMediaItems
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eThis method adds one or more media items to a specified album in a user's Google Photos library, provided the media items and albums were created by the developer via the API.\u003c/p\u003e\n"],["\u003cp\u003eUp to 50 media items can be added in a single request, and albums can hold a maximum of 20,000 media items; the request will fail if an invalid media item or album is specified.\u003c/p\u003e\n"],["\u003cp\u003eThe media items are added to the end of the album in the order specified and must be in the user's library.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required, and beginning March 31, 2025, functionality will be limited to interacting with media items created by your app due to scope changes.\u003c/p\u003e\n"]]],["This document details how to add media items to a Google Photos album via the API. Using a `POST` request to a specific URL, with the album's ID, one can add up to 50 media items to a user's album. The request body uses a JSON structure that specifies the `mediaItemIds`. Only items in the user's library, created by the developer through API, can be added. The entire request will fail if invalid data is given, and the call requires specific authorization scopes.\n"],null,["# Method: albums.batchAddMediaItems\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nAdds one or more app created media items in a user's Google Photos library to an app created album. The media items and albums must have been created by the developer via the API.\n\nMedia items are added to the end of the album. If multiple media items are given, they are added in the order specified in this call.\n\nEach album can contain up to 20,000 media items.\n\nPartial success is not supported. The entire request will fail if an invalid media item or album is specified.\n\n### HTTP request\n\n`POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------|\n| `albumId` | `string` Required. Identifier of the [Album](/photos/library/reference/rest/v1/albums#Album) that the media items are added to. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------|\n| ``` { \"mediaItemIds\": [ string ] } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `mediaItemIds[]` | `string` Required. Identifiers of the [MediaItem](/photos/library/reference/rest/v1/mediaItems#MediaItem)s to be added. The maximum number of media items that can be added in one call is 50. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `\n https://www.googleapis.com/auth/photoslibrary.appendonly`\n- `\n https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata`"]]
