Mengelola item media

Selain mengakses media setelah mengunggah item, Anda dapat juga mengubah deskripsinya.

Cakupan otorisasi yang diperlukan

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

Mengubah deskripsi item media

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

Untuk mengubah deskripsi item media, aplikasi Anda harus sudah mengupload media item tersebut, dan pengguna yang saat ini diotentikasi haruslah pemiliknya. Deskripsi dapat panjangnya tidak 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
}