คุณกำลังดูเอกสารประกอบเดิมสำหรับ Google Photos Library API
Method: albums.batchRemoveMediaItems
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[[["\u003cp\u003eThe API removes one or more media items from a specified album, requiring the media items and album to be created by the developer.\u003c/p\u003e\n"],["\u003cp\u003eIt supports removing media items from shared albums only if added by the user or if the user created the album.\u003c/p\u003e\n"],["\u003cp\u003eRequests must include the \u003ccode\u003ealbumId\u003c/code\u003e as a path parameter and an array of \u003ccode\u003emediaItemIds\u003c/code\u003e in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe API follows an all-or-nothing approach, failing the entire request if any specified media item or album is invalid.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/photoslibrary\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This describes the process to remove media items from an album using the Google Photos Library API. A `POST` request to `https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems` is required, including the `albumId` in the path. The request body, in JSON format, needs an array of `mediaItemIds` to remove, up to 50. This action requires the `https://www.googleapis.com/auth/photoslibrary` OAuth scope. A successful request returns an empty response. If an error occurs, no media items will be removed.\n"],null,["# Method: albums.batchRemoveMediaItems\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\nRemoves one or more media items from a specified album. The media items and the album must have been created by the developer via the API.\n\nFor albums that are shared, this action is only supported for media items that were added to the album by this user, or for all media items if the album was created by this user.\n\nPartial success is not supported. The entire request will fail and no action will be performed on the album if an invalid media item or album is specified.\n\n### HTTP request\n\n`POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems`\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 to be removed from. |\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 removed. Must not contain repeated identifiers and cannot be empty. The maximum number of media items that can be removed in one call is 50. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/photoslibrary`"]]
