Method: albums.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan semua album yang dibuat oleh aplikasi Anda.
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.readonly.appcreateddata
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-04-01 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-04-01 UTC."],[[["Lists all albums displayed in the user's Google Photos Albums tab."],["Allows filtering by page size, page token, and excluding non-app created data."],["Responses include an array of albums and a token for retrieving further pages."],["Requires specific authorization scopes for access, with some legacy scopes being phased out."],["Functionality will be limited to app-created media starting March 31, 2025."]]],["This document details how to retrieve a list of albums from the Google Photos app using the `GET https://photoslibrary.googleapis.com/v1/albums` request. The request requires no body but accepts `pageSize`, `pageToken`, and `excludeNonAppCreatedData` as query parameters. The response includes an array of albums and an optional `nextPageToken` for pagination. It also outlines the required authorization scopes and indicates that certain scopes will limit functionality to app-created content after March 31, 2025.\n"]]
