Method: albums.list

Lista wszystkich albumów wyświetlanych 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. 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:

Zapis JSON 
{
  "albums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
Pola
albums[]

object (Album)

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.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata