Mengelola item media

Selain accessing item media setelah menguploadnya, Anda juga dapat mengubah deskripsinya.

Cakupan otorisasi yang diperlukan

Untuk mengubah deskripsi item media setelah dibuat, gunakan cakupan photoslibrary.edit.appcreateddata.

Mengubah deskripsi item media

Untuk mengubah deskripsi item media, buat media items update call dengan ID item media tersebut, dan sertakan deskripsi baru dalam permintaan.

Untuk mengubah deskripsi item media, aplikasi Anda harus sudah mengupload item media, dan pengguna yang saat ini diautentikasi harus menjadi pemiliknya. Panjang deskripsi tidak boleh lebih dari 1.000 karakter.

REST

Berikut adalah header permintaan PATCH untuk memperbarui deskripsi item media:

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

Permintaan ini menentukan properti yang diperbarui dengan menyertakan mask kolom, yang ditunjukkan oleh parameter updateMask di URL.

Sertakan deskripsi baru dalam isi permintaan:

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

Jika berhasil, respons akan menampilkan item media yang diperbarui:

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