Method: mediaItems.list

Menampilkan daftar item media standby dari sumber media yang dikonfigurasi pengguna untuk perangkat yang ditentukan.

Secara default, listMediaItems memberikan pengalaman Standby, yang menampilkan kumpulan item media yang diseleksi dari semua sumber yang dikonfigurasi pengguna.

Atau, Anda dapat menyertakan mediaSourceId dalam permintaan untuk mengambil daftar item yang di-paging dari sumber media tertentu, sehingga memungkinkan pemfilteran yang lebih tradisional.

Aplikasi klien dibatasi hingga 240 permintaan per perangkat per hari.

Error FAILED_PRECONDITION akan terjadi jika pengguna belum mengonfigurasi sumber media apa pun.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
deviceId

string

Wajib. ID unik untuk perangkat ini.
mediaSourceId

string

Opsional. Untuk pengalaman Standby, hapus kolom ini. Tindakan ini akan menampilkan kumpulan item media yang diseleksi dari semua sumber yang dikonfigurasi. Jumlah item yang ditampilkan akan memenuhi permintaan pageSize Anda, hingga maksimum 100 item. Jika ditentukan, hanya item dari sumber media yang ditentukan yang akan ditampilkan.

id harus berasal dari sumber yang dipilih oleh pengguna untuk perangkat yang ditentukan (yaitu salah satu dari AmbientDevice.media_sources.id).

Perhatikan bahwa highlights tidak didukung meskipun merupakan sumber yang dipilih untuk perangkat ini oleh pengguna. Menetapkan kolom ini ke highlights akan menampilkan error INVALID_ARGUMENT.
pageSize

integer

Opsional. Jumlah maksimum item media yang akan ditampilkan.

Layanan akan memenuhi permintaan pageSize Anda, meskipun mungkin menampilkan lebih sedikit item daripada yang ditentukan (termasuk nol hasil).

Jika pageSize tidak ditentukan atau ditetapkan ke 0, maksimal 50 item media akan ditampilkan. Nilai yang lebih besar dari 100 akan dikonversi menjadi nilai maksimum yang diizinkan sebesar 100. Memberikan nilai negatif akan menghasilkan error INVALID_ARGUMENT.
pageToken

string

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

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons terhadap metode mediaItems.list.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (AmbientMediaItem)

Halaman item media standby untuk ditampilkan perangkat.
nextPageToken

string

Jika ditetapkan, kolom ini dapat digunakan sebagai pageToken dalam panggilan mediaItems.list berikutnya untuk mengambil halaman item berikutnya.

Jika kolom ini dihilangkan, hal ini tidak selalu menunjukkan bahwa tidak ada lagi konten yang tersedia untuk diambil, tetapi halaman konten berikutnya mungkin berisi item media yang sudah ditampilkan di halaman sebelumnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/photosambient.mediaitems