Method: albums.patch
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عدِّل الألبوم الذي أنشأه التطبيق باستخدام id المحدّد. لا تتم قراءة سوى حقول id وtitle وcoverPhotoMediaItemId في الألبوم. يجب أن يكون المطوّر هو من أنشأ الألبوم من خلال واجهة برمجة التطبيقات.
طلب HTTP
PATCH https://photoslibrary.googleapis.com/v1/albums/{album.id}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],["To update an album, use a `PATCH` request to the specified URL, including the `album.id` as a path parameter. The `updateMask` query parameter is required to specify fields to update, which can be `title` or `coverPhotoMediaItemId`. The request body contains the album data. The response body returns the updated album. Authorization requires the `https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata` scope. The provided album must have been created by the developer via the API and owned by the user.\n"]]
