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