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