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

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

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

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

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

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

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

راحة

في ما يلي عنوان طلب 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"
}

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
}