Maksymalna liczba albumów do zwrócenia w odpowiedzi. Zwrócona liczba albumów może być mniejsza niż podana. Wartość domyślna pageSize to 20, a maksymalna – 50.
pageToken
string
token kontynuacji umożliwiający pobranie następnej strony wyników. Dodanie tego do żądania spowoduje zwrócenie wierszy po pageToken. Wartość pageToken powinna być zwracana w parametrye nextPageToken w odpowiedzi na żądanie listAlbums.
excludeNonAppCreatedData
boolean
Jeśli jest ustawiony, z wyników wykluczone są elementy multimedialne, które nie zostały utworzone przez tę aplikację. Domyślnie ustawiona jest wartość 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 wybranych albumów.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Tylko dane wyjściowe. Lista albumów wyświetlana 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.
[[["Ł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-01-30 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"]]