شما در حال مشاهده اسناد قدیمی برای Google Photos Library API هستید.
Method: albums.patch
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
آلبوم را با id
مشخص شده به روز کنید. فقط فیلدهای id
، title
و coverPhotoMediaItemId
آلبوم خوانده می شود. آلبوم باید توسط توسعه دهنده از طریق API ایجاد شده باشد و باید متعلق به کاربر باشد.
درخواست HTTP
PATCH https://photoslibrary.googleapis.com/v1/albums/{album.id}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
album.id | string شناسه آلبوم این یک شناسه ثابت است که میتواند بین جلسات برای شناسایی این آلبوم استفاده شود. |
پارامترهای پرس و جو
پارامترها |
---|
updateMask | string ( FieldMask format) مورد نیاز. فیلدهایی را در آلبوم ارائه شده برای به روز رسانی مشخص کنید. تنها مقادیر معتبر عبارتند از title و coverPhotoMediaItemId . این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" . |
درخواست بدن
بدنه درخواست حاوی نمونهای از Album
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Album
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],["This describes updating an album using a PATCH request to `https://photoslibrary.googleapis.com/v1/albums/{album.id}`. The `album.id` path parameter identifies the target album. The `updateMask` query parameter, with values `title` or `coverPhotoMediaItemId`, specifies which album fields to update. The request body contains the updated album information, while the successful response body returns the updated album. This operation requires the `https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata` authorization scope. Only albums created via the API and owned by the user can be modified.\n"],null,[]]