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

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

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

لتغيير أوصاف عناصر الوسائط بعد إنشائها، استخدِم نطاق واحد (photoslibrary.edit.appcreateddata).

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

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

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

راحة

إليك عنوان طلب تصحيح لتعديل وصف عنصر الوسائط:

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"
}

Java

try {
  // Update the description of the media item.
  // The new description must not be null.
  MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description");
} catch (ApiException e) {
  // Handle error
}

PHP

try {

    // ID of the media item to update.
    $mediaItemId = "MEDIA_ITEM_ID";

    // New description of the media item.
    $newDescription = "new-media-item-description";

    // Update the description of the media item identified.
    $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription);

} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}