คุณกำลังดูเอกสารประกอบเดิมสำหรับ Google Photos Library API
Method: albums.batchAddMediaItems
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[[["\u003cp\u003eThis operation adds one or more media items to a specified album in a user's Google Photos library, given the media items and album were created via the API.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a JSON array of media item identifiers (\u003ccode\u003emediaItemIds\u003c/code\u003e) to be added to the album identified by the \u003ccode\u003ealbumId\u003c/code\u003e path parameter.\u003c/p\u003e\n"],["\u003cp\u003eEach album can hold a maximum of 20,000 media items, and a single request can add up to 50 media items.\u003c/p\u003e\n"],["\u003cp\u003eProper authorization is required, utilizing one of the specified OAuth scopes for accessing and modifying the user's Google Photos library.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the API returns an empty response body, signifying the media items were added to the album.\u003c/p\u003e\n"]]],["This API endpoint (`POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems`) adds media items to a Google Photos album. The `albumId` is a required path parameter. The request body must contain a JSON array of `mediaItemIds`, specifying the media to add (up to 50). Albums must be owned or the user must be a collaborator on it. Media items must be in the user's library and added in the specified order. Success returns an empty response body. Requires specific OAuth 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 media items in a user's Google Photos library to an 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\nOnly media items that are in the user's library can be added to an album. For albums that are shared, the album must either be owned by the user or the user must have joined the album as a collaborator.\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/legacy/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/legacy/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- `https://www.googleapis.com/auth/photoslibrary`\n- `https://www.googleapis.com/auth/photoslibrary.appendonly`\n- `https://www.googleapis.com/auth/photoslibrary.sharing`"]]
