Method: mediaItems.list

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

Ein FAILED_PRECONDITION-Fehler wird zurückgegeben, wenn der Nutzer die Auswahl der Medienelemente für die angegebene Sitzung noch nicht abgeschlossen hat. In diesem Fall sollte Ihre Anwendung sessions.get abfragen, bis die Sitzung bereit ist, bevor Sie diese Methode noch einmal versuchen.

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 (auch null Ergebnisse). Wenn nicht angegeben oder auf „0“ festgelegt, werden maximal 50 Medienelemente zurückgegeben. Der Höchstwert beträgt 100. Werte über 100 werden auf 100 festgelegt. Negative Werte führen zu einem INVALID_ARGUMENT-Fehler.
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

Antwort auf die mediaItems.list-Methode.

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

Wenn dieses Feld festgelegt ist, kann es als pageToken in einem nachfolgenden mediaItems.list-Aufruf verwendet werden, um die nächste Seite der ausgewählten Medienelemente abzurufen.

Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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