Przeglądasz starszą dokumentację interfejsu Google Photos Library API.
Method: albums.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyświetla listę wszystkich albumów widocznych użytkownikowi na karcie Albumy w aplikacji Zdjęcia Google.
Żądanie HTTP
GET https://photoslibrary.googleapis.com/v1/albums
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry |
pageSize |
integer
Maksymalna liczba albumów do zwrócenia w odpowiedzi. Liczba albumów, które mogą zostać zwrócone, będzie mniejsza niż określona liczba. Wartość domyślna pageSize to 20, maksymalna to 50.
|
pageToken |
string
Token kontynuacji, który pozwala wyświetlić następną stronę wyników. Dodanie tego do żądania spowoduje zwrócenie wierszy po pageToken. Wartość pageToken powinna być zwracana w parametry nextPageToken w odpowiedzi na żądanie listAlbums.
|
excludeNonAppCreatedData |
boolean
Jeśli jest ustawione, wyniki nie obejmują elementów multimedialnych, które nie zostały utworzone przez tę aplikację. Wartość domyślna to fałsz (zwracane są wszystkie albumy). To pole jest ignorowane, jeśli używany jest zakres photoslibrary.readonly.appcreateddata.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Lista żądanych albumów.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"albums": [
{
object (Album)
}
],
"nextPageToken": string
} |
| Pola |
albums[] |
object (Album)
Tylko dane wyjściowe. Lista albumów widocznych na karcie Albumy w aplikacji Zdjęcia Google użytkownika.
|
nextPageToken |
string
Tylko dane wyjściowe. Token do użycia w celu pobrania następnego zestawu albumów. Wypełnione, jeśli w ramach tego żądania należy pobrać więcej albumów.
|
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eLists all albums displayed in the user's Google Photos Albums tab using the \u003ccode\u003eGET https://photoslibrary.googleapis.com/v1/albums\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eAllows pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters to control the number of albums returned and retrieve subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of \u003ccode\u003ealbums\u003c/code\u003e and a \u003ccode\u003enextPageToken\u003c/code\u003e for further navigation if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with one of the specified OAuth scopes, such as \u003ccode\u003ehttps://www.googleapis.com/auth/photoslibrary\u003c/code\u003e, for access.\u003c/p\u003e\n"],["\u003cp\u003eCan exclude non-app created data using the \u003ccode\u003eexcludeNonAppCreatedData\u003c/code\u003e parameter or the \u003ccode\u003ephotoslibrary.readonly.appcreateddata\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["To retrieve a user's albums from Google Photos, send a `GET` request to `https://photoslibrary.googleapis.com/v1/albums`. The request body must be empty. Optional query parameters include `pageSize` (default 20, max 50), `pageToken` for pagination, and `excludeNonAppCreatedData`. The response contains an array of album objects and `nextPageToken` for subsequent requests. Authorization requires one of three specified OAuth scopes.\n"],null,[]]
