أنت تعرض المستندات القديمة لواجهة برمجة التطبيقات Google Photos Library API.
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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-07 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-07 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This API updates an album with a specified ID, modifying only the title and cover photo, if provided in the request."],["The album being updated must have been created by the developer via the API and be owned by the user."],["A `PATCH` request is used, targeting the album's ID in the URL."],["An `updateMask` query parameter is required to specify which album fields (title, coverPhotoMediaItemId) are being updated."],["The request body should contain an `Album` object with the updated fields, and the response, if successful, also contains an `Album` object."]]],["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"]]
