أنت تعرض المستندات القديمة لواجهة برمجة التطبيقات 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 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 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."]]],[]]