Method: mediaItems.batchGet

Menampilkan daftar item media untuk ID item media yang ditentukan. Item ditampilkan dalam urutan yang sama dengan ID yang diberikan.

Permintaan HTTP

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
mediaItemIds[]

string

Wajib. ID item media yang akan diminta. Tidak boleh berisi ID berulang dan tidak boleh kosong. Jumlah maksimum item media yang dapat diambil dalam satu panggilan adalah 50.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons untuk mengambil daftar item media.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Kolom
mediaItemResults[]

object (MediaItemResult)

Hanya output. Daftar item media yang diambil. Perhatikan bahwa meskipun panggilan ke mediaItems.batchGet berhasil, mungkin ada kegagalan untuk beberapa item media dalam batch. Kegagalan ini ditunjukkan di setiap MediaItemResult.status.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

Hasil pengambilan item media.

Representasi JSON
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Kolom
status

object (Status)

Jika terjadi error saat mengakses item media ini, kolom ini akan diisi dengan informasi yang terkait dengan error tersebut. Untuk mengetahui detail terkait kolom ini, lihat Status.

mediaItem

object (MediaItem)

Item media yang diambil dari galeri foto pengguna. Kolom ini diisi jika tidak terjadi error dan item media berhasil diambil.