Method: albums.list

Mencantumkan semua album yang ditampilkan kepada pengguna di tab Album aplikasi Google Foto.

Permintaan HTTP

GET https://photoslibrary.googleapis.com/v1/albums

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
pageSize

integer

Jumlah maksimum album yang akan ditampilkan dalam respons. Album yang ditampilkan mungkin lebih sedikit dari jumlah yang ditentukan. pageSize default adalah 20, maksimumnya adalah 50.
pageToken

string

Token lanjutan untuk mendapatkan halaman hasil berikutnya. Menambahkan ini ke permintaan akan menampilkan baris setelah pageToken. pageToken harus berupa nilai yang ditampilkan dalam parameter nextPageToken sebagai respons terhadap permintaan listAlbums.
excludeNonAppCreatedData

boolean

Jika ditetapkan, hasil akan mengecualikan item media yang tidak dibuat oleh aplikasi ini. Setelan defaultnya adalah salah (semua album ditampilkan). Kolom ini diabaikan jika cakupan photoslibrary.readonly.appcreateddata digunakan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Daftar album yang diminta.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "albums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
Kolom
albums[]

object (Album)

Hanya output. Daftar album yang ditampilkan di tab Album pada aplikasi Google Foto pengguna.
nextPageToken

string

Hanya output. Token yang akan digunakan untuk mendapatkan kumpulan album berikutnya. Diisi jika ada lebih banyak album yang akan diambil untuk permintaan ini.

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