شما در حال مشاهده اسناد قدیمی برای Google Photos Library API هستید.
Method: albums.unshare
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
آلبومی که قبلاً به اشتراک گذاشته شده است را به عنوان خصوصی علامت گذاری می کند. این به این معنی است که آلبوم دیگر به اشتراک گذاشته نمی شود و همه افراد غیر مالک دسترسی به آلبوم را از دست خواهند داد. تمام محتوای غیر مالک از آلبوم حذف خواهد شد. اگر فردی غیر مالک قبلاً آلبوم را به کتابخانه خود اضافه کرده باشد، همه عکسها را در کتابخانه خود نگه میدارد. این عمل فقط در آلبوم هایی قابل انجام است که توسط توسعه دهنده از طریق API ایجاد شده اند.
درخواست HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:unshare
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
albumId | string مورد نیاز. شناسه آلبومی که باید لغو اشتراکگذاری شود. این شناسه آلبوم باید متعلق به آلبومی باشد که توسط سازنده ایجاد شده است. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ خالی است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photoslibrary.sharing
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eUnshares a previously shared album, making it private and removing non-owner access.\u003c/p\u003e\n"],["\u003cp\u003eNon-owners who added the album to their library will retain their photos, but lose access to the shared album.\u003c/p\u003e\n"],["\u003cp\u003eOnly albums created by the developer via the API can be unshared using this method.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful response will also be empty.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/photoslibrary.sharing\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["The content details how to unshare a previously shared album via API. It uses a `POST` request to the provided URL, including the `albumId` as a path parameter. The request body must be empty. Upon successful execution, the response body will also be empty. This action removes non-owners' access and content from the album. Only albums created through the API can be unshared. It also requires the `https://www.googleapis.com/auth/photoslibrary.sharing` OAuth scope.\n"],null,["# Method: albums.unshare\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nMarks a previously shared album as private. This means that the album is no longer shared and all the non-owners will lose access to the album. All non-owner content will be removed from the album. If a non-owner has previously added the album to their library, they will retain all photos in their library. This action can only be performed on albums which were created by the developer via the API.\n\n### HTTP request\n\n`POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:unshare`\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 to be unshared. This album id must belong to an album created by the developer. |\n\n### Request body\n\nThe request body must be empty.\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.sharing`"]]