Method: devices.list

Listet die Bildschirmschoner auf, die mit dem Konto des authentifizierten Nutzers verbunden sind. Gibt nur Geräte zurück, die von der aufrufenden Anwendung erstellt wurden.

HTTP-Anfrage

GET https://photosambient.googleapis.com/v1/devices

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl von Geräten, 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 Geräte 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 devices.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 devices.list.

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

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

object (AmbientDevice)

Eine Seite mit Geräten, die mit dem Google Fotos-Konto des Nutzers verbunden sind.
nextPageToken

string

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

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/photosambient.mediaitems