Method: albums.list

Zawiera listę wszystkich albumów wyświetlanych użytkownikowi na karcie Albumy 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, może być mniejsza od określonej liczby. Wartość domyślna pageSize to 20, a maksymalna to 50.
pageToken

string

Token kontynuacji, który pozwala wyświetlić następną stronę wyników. Dodanie tego elementu do żądania zwraca wiersze po kolumnie pageToken. pageToken powinna być wartością zwracaną w parametrze nextPageToken w odpowiedzi na żądanie listAlbums.
excludeNonAppCreatedData

boolean

Jeśli zasada jest skonfigurowana, wyniki wykluczają elementy multimedialne, 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 albumów, których potrzebujesz.

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, którego należy użyć do pobrania kolejnego zestawu albumów. Pole wypełnione, jeśli istnieje więcej albumów do pobrania dla tego żądania.

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