Medya öğelerini yönet

Medya öğelerine yükledikten sonra accessing yanı sıra açıklamalarını da değiştirebilirsiniz.

Gerekli yetkilendirme kapsamı

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

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

Bir medya öğesinin açıklamasını değiştirmek için medya öğesinin tanımlayıcısıyla media items update call yapın ve yeni açıklamayı isteğe ekleyin.

Bir medya öğesinin açıklamasını değiştirmek için uygulamanızın medya öğesini yüklemiş olması ve kimliği doğrulanmış kullanıcının sahip olması gerekir. Açıklamalar en fazla 1.000 karakter uzunluğunda olabilir.

REST

Burada, bir medya öğesi açıklamasını güncellemek için YAMA isteği başlığını görebilirsiniz:

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

Bu istek, URL'deki updateMask parametresiyle belirtilen bir alan maskesi ekleyerek hangi özelliklerin güncellendiğini belirler.

Yeni açıklamayı isteğin gövdesine 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
}