Method: mediaItems.list

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

Jeśli w sesji nie ma jeszcze żadnych wybranych elementów multimedialnych i dlatego nie może ona zwrócić treści multimedialnych, wystąpi błąd FAILED_PRECONDITION. W takiej sytuacji aplikacje działające na urządzeniach z ograniczoną ilością danych wejściowych powinny renderować kod QR z kodem pickerUri sesji, zachęcając użytkownika do zeskanowania kodu i wybrania elementów multimedialnych w interfejsie selektora Zdjęć Google. Czekając, aż użytkownik wybierze elementy, klienci powinni przeprowadzać ankietę w usłudze sessions.get co pollingConfig.pollInterval, aż do pickedItemsSet = true w odpowiedzi sessions.get. Wtedy klienci mogą wznowić dzwonienie pod numer mediaItems.list i spodziewać się pomyślnej odpowiedzi.

Żą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 wyników od tej wartości (w tym zero wyników). Jeśli wartość jest nieokreślona lub ma wartość 0, zwróconych zostanie maksymalnie 50 elementów multimedialnych. Maksymalna wartość to 100. wartości powyżej 100 zostaną zmienione na 100. Wartości ujemne będą powodować wystąpienie błędu INVALID_ARGUMENT.
pageToken

string

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

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na RPC 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

Token, który może zostać wysłany jako pageToken w celu pobrania następnej strony w żądaniu mediaItems.list.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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