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. Lebih sedikit album yang mungkin ditampilkan daripada jumlah yang ditentukan. pageSize default adalah 20, maksimum 50.
pageToken

string

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

boolean

Jika disetel, hasilnya akan mengecualikan item media yang tidak dibuat oleh aplikasi ini. Nilai defaultnya adalah false (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 album lain yang dapat 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