REST Resource: sessions

Ressource: PickingSession

Darstellung einer Nutzersitzung, in der der Nutzer Fotos und Videos mit Google Fotos auswählen kann.

JSON-Darstellung
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "mediaItemsSet": boolean
}
Felder
id

string

Nur Ausgabe. Die von Google generierte Kennung für diese Sitzung.

pickerUri

string

Nur Ausgabe. Der URI, über den der Nutzer zu Google Fotos (im Web) weitergeleitet wird, damit er Fotos und Videos für die aktuelle Sitzung auswählen kann.

Damit diese Seite angezeigt werden kann, muss der Nutzer in seinem Webbrowser in dem Google-Konto angemeldet sein, zu dem diese Sitzung gehört.

Die pickerUri kann aus Sicherheitsgründen nicht in einem Iframe geöffnet werden.

pollingConfig

object (PollingConfig)

Nur Ausgabe. Die empfohlene Konfiguration, die Anwendungen beim Abfragen von sessions.get verwenden sollten.

Dieses Feld wird nur ausgefüllt, wenn für diese Sitzung noch keine Medienelemente ausgewählt wurden (d.h. mediaItemsSet ist falsch).

expireTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem der Zugriff auf diese Sitzung (und die ausgewählten Medienelemente) abläuft.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

mediaItemsSet

boolean

Nur Ausgabe. Wenn true festgelegt ist, wurden für diese Sitzung Medienelemente ausgewählt und deine Anwendung kann die Liste der ausgewählten Medienelemente über mediaItems.list anfordern.

PollingConfig

Konfiguration für das Abfragen der API.

JSON-Darstellung
{
  "pollInterval": string,
  "timeoutIn": string
}
Felder
pollInterval

string (Duration format)

Nur Ausgabe. Empfohlene Zeit zwischen Abfrageanfragen.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

timeoutIn

string (Duration format)

Nur Ausgabe. Die Zeitspanne, nach der der Client das Polling beenden soll.

Ein Wert von 0 gibt an, dass der Client die Abfrage beenden soll, falls er dies noch nicht getan hat.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

Methoden

create

Erzeugt eine neue Sitzung, in der der Nutzer Fotos und Videos für den Zugriff von Drittanbietern auswählen kann.

delete

Löscht die angegebene Sitzung.

get

Ruft Informationen zur angegebenen Sitzung ab.