Method: mediaItems.batchGet

Menampilkan daftar item media untuk ID item media yang ditentukan. Item dikembalikan dalam urutan yang sama seperti ID yang diberikan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
mediaItemIds[]

string

Wajib diisi. 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 diambil. Perlu diketahui bahwa meskipun panggilan ke mediaItems.batchGet berhasil, kemungkinan terdapat 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

Jawaban Anda

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 library pengguna. Kolom ini diisi jika tidak terjadi error dan item media berhasil diambil.