Method: albums.batchRemoveMediaItems
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis operation removes one or more media items from a specified album, requiring that both the items and the album were created by the developer via the API.\u003c/p\u003e\n"],["\u003cp\u003eOnly media items added by the user or the entire album if created by the user can be removed from shared albums.\u003c/p\u003e\n"],["\u003cp\u003eThe request will entirely fail if any invalid media item or album is specified, as partial success is not supported.\u003c/p\u003e\n"],["\u003cp\u003eTo use this feature, you need to send a POST request to \u003ccode\u003ehttps://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems\u003c/code\u003e, providing the \u003ccode\u003ealbumId\u003c/code\u003e and a list of \u003ccode\u003emediaItemIds\u003c/code\u003e in the request body.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required with either the \u003ccode\u003ehttps://www.googleapis.com/auth/photoslibrary\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/photoslibrary.edit.appcreateddata\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines the process of removing media items from an album via the Google Photos API. It involves a `POST` request to a specific URL using the `albumId` as a path parameter. The request body, in JSON format, requires an array of `mediaItemIds` which are to be removed. The `mediaItemIds` array must not be empty or contain duplicates, limited to a maximum of 50 IDs. Successful requests result in an empty response body, while failures result in no changes. Authorization requires specific OAuth scopes.\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 app created media items from a specified app created album. The media items and the album must have been created by the developer via the API.\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/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/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 one of the following OAuth scopes:\n\n- `\n https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata`"]]
