Method: albums.list

Mencantumkan semua album yang ditampilkan kepada pengguna di tab Album di 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. Jumlah album yang mungkin ditampilkan lebih sedikit dari jumlah yang ditentukan. pageSize default adalah 20, sedangkan maksimumnya adalah 50.
pageToken

string

Token kelanjutan 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 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 apakah 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