Method: albums.batchAddMediaItems

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

Item media akan ditambahkan ke 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 koleksi pengguna yang dapat ditambahkan ke album. Untuk album yang dibagikan, album tersebut harus dimiliki oleh pengguna atau pengguna harus sudah bergabung dengan album tersebut 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