Method: sharedAlbums.list

Mencantumkan semua album bersama yang tersedia di tab Berbagi di aplikasi Google Foto pengguna.

Permintaan HTTP

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

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 listSharedAlbums.

excludeNonAppCreatedData

boolean

Jika disetel, hasilnya akan mengecualikan item media yang tidak dibuat oleh aplikasi ini. 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 bersama yang diminta.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (Album)

Hanya output. Daftar album bersama.

nextPageToken

string

Hanya output. Token yang akan digunakan untuk mendapatkan kumpulan album bersama berikutnya. Diisi jika ada lebih banyak album bersama 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals