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. Liczba albumów, które mogą zostać zwrócone, będzie mniejsza niż określona liczba. Wartość domyślna pageSize to 20, a maksymalna – 50.
pageToken

string

Token kontynuacji, który pozwala wyświetlić następną stronę wyników. Dodanie go do żądania spowoduje zwrócenie wierszy po elemencie pageToken. Wartość pageToken powinna być wartością zwracaną w parametrze 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 zapytania 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals