Method: sharedAlbums.list

Wyświetla listę wszystkich udostępnionych albumów dostępnych na karcie Udostępnianie w aplikacji Zdjęcia Google użytkownika.

Żądanie HTTP

GET https://photoslibrary.googleapis.com/v1/sharedAlbums

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 parametrze nextPageToken w odpowiedzi na żądanie listSharedAlbums.

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 żądanych albumów udostępnionych.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

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

object (Album)

Tylko dane wyjściowe. Lista udostępnionych albumów.

nextPageToken

string

Tylko dane wyjściowe. Token do użycia w celu pobrania następnego zestawu udostępnionych albumów. Wypełnione, jeśli w ramach tego zapytania należy pobrać więcej albumów udostępnionych.

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