REST Resource: devices

Ressource: AmbientDevice

Darstellung eines Geräts im Modus „Inaktiv“.

JSON-Darstellung 
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
Felder
id

string

Nur Ausgabe. Die eindeutige Kennung für dieses Gerät.
displayName

string

Erforderlich. Ein benutzerdefinierter Anzeigename für dieses Gerät.

Dieser ist für Nutzer in den Einstellungen der Google Fotos App sichtbar, kann aber nur über diese API bearbeitet werden.

Gültige Anzeigenamen müssen zwischen 1 und 100 Zeichen lang sein.
mediaSources[]

object (AmbientMediaSource)

Nur Ausgabe. Die für dieses Gerät festgelegten Medienquellen.

Medienquellen sind Alben oder Fotosammlungen, die der Nutzer zur Anzeige auf einem Gerät auswählt.

Hinweis: Dieses Feld ist leer, wenn der Nutzer keine Medienquellen für dieses Gerät ausgewählt hat (mediaSourcesSet = false).
settingsUri

string

Nur Ausgabe. Der URI, über den der Nutzer in der Google Fotos App zu den Geräteeinstellungen weitergeleitet wird.
createTime

string (Timestamp format)

Nur Ausgabe. Die Zeit, zu der dieses Gerät erstellt wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
pollingConfig

object (PollingConfig)

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

boolean

Nur Ausgabe. Wenn diese Option festgelegt ist, wurden für dieses Gerät Medienquellen konfiguriert und Clients sollten eine Liste der Medienelemente für dieses Gerät anfordern können.

AmbientMediaSource

Stellt eine Medienquelle dar, die ein Nutzer für ein Gerät im Inaktivmodus ausgewählt hat.

JSON-Darstellung 
{
  "id": string,
  "displayName": string
}
Felder
id

string

Nur Ausgabe. Kennung der Umgebungsmedienquelle.
displayName

string

Nur Ausgabe. Anzeigename für diese Medienquelle.

PollingConfig

Konfiguration für das Abfragen der API.

JSON-Darstellung 
{
  "pollInterval": 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".

Methoden

create

 Erstellt ein Ambient-Gerät im Google Fotos-Konto des Nutzers.

delete

 Das angegebene Gerät wird aus dem Google Fotos-Konto des Nutzers entfernt.

get

 Ruft Informationen zum angegebenen Gerät ab.

patch

 Aktualisiert Informationen zum angegebenen Gerät.