Method: mediaItems.list

Zwraca listę elementów multimedialnych wybranych przez użytkownika podczas określonej sesji.

Jeśli użytkownik nie wybrał jeszcze wszystkich elementów multimedialnych na potrzeby określonej sesji, zwracany jest błąd FAILED_PRECONDITION. W tym scenariuszu aplikacja powinna sprawdzać wartość sessions.get, aż sesja będzie gotowa, a potem ponownie użyć tej metody.

Żądanie HTTP

GET https://photospicker.googleapis.com/v1/mediaItems

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
sessionId

string

Wymagane. Wygenerowany przez Google identyfikator tej sesji.
pageSize

integer

Opcjonalnie: Maksymalna liczba elementów multimedialnych do zwrócenia.

Usługa może zwrócić mniej niż tę wartość (w tym zero wyników). Jeśli nie podano tej wartości lub ustawiono ją na 0, zwracana jest maksymalnie 50 elementów multimediów. Maksymalna wartość to 100. Wartości powyżej 100 zostaną skonwertowane na 100. Wartości ujemne spowodują błąd INVALID_ARGUMENT.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji mediaItems.list. Podaj ten parametr, aby pobrać kolejną stronę.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na metodę mediaItems.list.

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

Zapis JSON 
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Pola
mediaItems[]

object (PickedMediaItem)

Strona z wybranymi elementami multimedialnymi.
nextPageToken

string

Jeśli to pole jest ustawione, można użyć go jako pageToken w kolejnym wywołaniu mediaItems.list, aby pobrać kolejną stronę wybranych elementów multimedialnych.

Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly