إدارة ملفات الوسائط

بالإضافة إلى الوصول إلى ملفات الوسائط واستردادها بعد تحميلها، يمكنك أيضًا تغيير أوصافها.

نطاق التفويض المطلوب

يتطلب تغيير أوصاف المحتوى الذي أنشأه التطبيق الحصول على نطاق photoslibrary.edit.appcreateddata. لمزيد من المعلومات عن النطاقات، يُرجى الاطّلاع على نطاقات التفويض.

تغيير أوصاف عناصر الوسائط

لتغيير وصف عنصر وسائط، أنشئ media items update call باستخدام المعرّف لعنصر الوسائط، وأدرِج الوصف الجديد في الطلب.

لتغيير وصف عنصر وسائط، يجب أن يكون تطبيقك قد حمّل عنصر الوسائط، ويجب أن يكون المستخدم الذي تمت مصادقته حاليًا هو المالك. يجب ألا يزيد طول الوصف عن 1,000 حرف.

REST

في ما يلي عنوان طلب PATCH لتعديل وصف عنصر وسائط:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

يحدِّد هذا الطلب المواقع التي يتم تعديلها عن طريق تضمين قناع حقل، يُشار إليه بالمَعلمة updateMask في عنوان URL.

أدرِج الوصف الجديد في نص الطلب:

{
  "description": "new-media-item-description"
}

في حال نجاح العملية، يعرض الردّ عنصر الوسائط المعدَّل:

{
  "id": "media-item-id",
  "description": "new-media-item-description",
  "productUrl": "media-item-product-url",
  "baseUrl": "media-items-in-album",
  "mimeType": "mime-type-of-media",
  "mediaMetadata": {
    ...
  },
  "contributorInfo": {
    ...
  },
  "fileName": "item-filename"
}