Mengelola item media

Selain mengakses dan mengambil item media setelah menguploadnya, Anda juga dapat mengubah deskripsinya.

Cakupan otorisasi yang diperlukan

Mengubah deskripsi konten buatan aplikasi memerlukan cakupan photoslibrary.edit.appcreateddata. Untuk informasi selengkapnya tentang cakupan, lihat Cakupan otorisasi.

Mengubah deskripsi item media

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

Untuk mengubah deskripsi item media, aplikasi Anda harus telah 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"
}