Method: albums.batchAddMediaItems

Menambahkan satu atau beberapa item media di galeri Google Foto pengguna ke album. Item media dan album harus telah dibuat oleh developer melalui API.

Item media ditambahkan ke bagian akhir album. Jika beberapa item media diberikan, item tersebut akan ditambahkan dalam urutan yang ditentukan dalam panggilan ini.

Setiap album dapat berisi hingga 20.000 item media.

Hanya item media yang ada di galeri foto pengguna yang dapat ditambahkan ke album. Untuk album yang dibagikan, album tersebut harus dimiliki oleh pengguna atau pengguna harus bergabung ke album sebagai kolaborator.

Keberhasilan sebagian tidak didukung. Seluruh permintaan akan gagal jika item media atau album yang tidak valid ditentukan.

Permintaan HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
albumId

string

Wajib. ID Album tempat item media ditambahkan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "mediaItemIds": [
    string
  ]
}
Kolom
mediaItemIds[]

string

Wajib. ID MediaItem yang akan ditambahkan. Jumlah maksimum item media yang dapat ditambahkan dalam satu panggilan adalah 50.

Isi respons

Jika berhasil, isi respons akan kosong.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata