Method: mediaItems.patch

عدِّل عنصر الوسائط باستخدام id المحدّد. لا تتم قراءة سوى حقلَي id وdescription في عنصر الوسائط. يجب أن يكون قد أنشأ المطوّر عنصر الوسائط عبر واجهة برمجة التطبيقات، ويجب أن يكون ملكًا للمستخدم.

طلب HTTP

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/{mediaItem.id}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
mediaItem.id

string

معرّف لعنصر الوسائط هذا معرّف ثابت يمكن استخدامه بين الجلسات لتحديد عنصر الوسائط هذا.

مَعلمات طلب البحث

المعلمات
updateMask

string (FieldMask format)

مطلوب. حدِّد الحقول التي تريد تعديلها في ملف الوسائط المقدَّم. القيمة الصالحة الوحيدة لهذه العلامة هي description.

هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "user.displayName,photo"

نص الطلب

يحتوي نص الطلب على مثال MediaItem.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال MediaItem.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata