Method: albums.list

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 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 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

Zażądano listy 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. Wartość podawana, jeśli w przypadku tego żądania istnieje więcej albumów do pobrania.

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