Method: mediaItems.list

Menampilkan daftar item media yang dipilih oleh pengguna selama sesi tertentu.

Error FAILED_PRECONDITION akan ditampilkan jika sesi belum memiliki item media yang dipilih sehingga tidak dapat menampilkan konten media. Dalam skenario ini, aplikasi yang berjalan di perangkat dengan input terbatas harus merender kode QR yang mengenkode pickerUri sesi, yang meminta pengguna untuk memindai kode dan memilih item media di UI Pemilih Google Foto. Saat menunggu pengguna memilih itemnya, klien harus melakukan polling sessions.get, sekali setiap pollingConfig.pollInterval, hingga pickedItemsSet = true dalam respons sessions.get. Pada saat itu, klien dapat melanjutkan panggilan mediaItems.list dan berharap menerima respons yang berhasil.

Permintaan HTTP

GET https://photospicker.googleapis.com/v1/mediaItems

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
sessionId

string

Wajib. ID yang dibuat Google untuk sesi ini.
pageSize

integer

Opsional. Jumlah maksimum item media yang akan ditampilkan.

Layanan mungkin menampilkan lebih sedikit dari nilai ini (termasuk hasil nol). Jika tidak ditentukan atau disetel ke 0, maksimal 50 item media akan ditampilkan. Nilai maksimumnya adalah 100; nilai di atas 100 akan dikonversi menjadi 100. Nilai negatif akan menghasilkan error INVALID_ARGUMENT.
pageToken

string

Opsional. Token halaman, diterima dari panggilan mediaItems.list sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons terhadap RPC mediaItems.list.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Kolom
mediaItems[]

object (PickedMediaItem)

Halaman yang berisi item media yang dipilih.
nextPageToken

string

Token, yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya dalam permintaan mediaItems.list.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly