Method: mediaItems.list

Gibt eine Liste mit Medienelementen zurück, die der Nutzer während der angegebenen Sitzung ausgewählt hat.

Der Fehler FAILED_PRECONDITION wird zurückgegeben, wenn die Sitzung noch keine Medienelemente enthält und daher keine Medieninhalte zurückgeben kann. In diesem Szenario sollten Anwendungen, die auf Geräten mit begrenzter Eingabe ausgeführt werden, einen QR-Code rendern, der die pickerUri der Sitzung codiert. Dadurch wird der Nutzer aufgefordert, den Code zu scannen und in der Google Fotos-Auswahl Medienelemente auszuwählen. Während der Kunde darauf wartet, dass der Nutzer seine Elemente auswählt, sollte sessions.get einmal alle pollingConfig.pollInterval bis pickedItemsSet = true in der sessions.get-Antwort abgefragt werden. Danach können Clients wieder mediaItems.list aufrufen und erwarten, eine erfolgreiche Antwort zu erhalten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
sessionId

string

Erforderlich. Die von Google generierte Kennung für diese Sitzung.
pageSize

integer

Optional. Die maximale Anzahl der Medienelemente, die zurückgegeben werden sollen.

Der Dienst gibt möglicherweise weniger als diesen Wert zurück (einschließlich Nullergebnissen). Wenn nicht angegeben oder auf 0 festgelegt, werden maximal 50 Medienelemente zurückgegeben. Der Höchstwert ist 100. werden Werte über 100 in 100 umgewandelt. Negative Werte führen zum Fehler INVALID_ARGUMENT.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen mediaItems.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Antwort auf den RPC mediaItems.list.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Felder
mediaItems[]

object (PickedMediaItem)

Eine Seite mit ausgewählten Medienelementen.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite in einer mediaItems.list-Anfrage abzurufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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