Medya öğelerini yönet

Medya dosyalarına erişmenin yanı sıra öğeleri yükledikten sonra şunları yapabilirsiniz: ve açıklamalarını da değiştirebilir.

Gerekli yetkilendirme kapsamı

Medya öğelerinin açıklamalarını oluşturulduktan sonra değiştirmek için photoslibrary.edit.appcreateddata kapsamı.

Medya öğesi açıklamalarını değiştirme

Bir medya öğesinin açıklamasını değiştirmek için media items update call betimlemesini sağlayın ve yeni açıklamayı isteğinde bulunabilirsiniz.

Bir medya öğesinin açıklamasını değiştirmek için uygulamanızın medyayı yüklemiş olması gerekir öğesi (kimliği doğrulanmış olan kullanıcı) öğenin sahibi olmalıdır. Açıklamalar en fazla 1.000 karakter uzunluğunda olmalıdır.

REST

Bir medya öğesi açıklamasını güncellemek için yama isteği başlığını burada görebilirsiniz:

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

Bu istek, alan maskesi (URL'deki updateMask parametresiyle belirtilir).

İsteğin gövdesine yeni açıklamayı ekleyin:

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

Başarılı olursa yanıt, güncellenmiş medya öğesini döndürür:

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