Method: devices.create

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

Wenn ein Gerät mit der angegebenen requestId bereits vorhanden ist, wird der Fehler ALREADY_EXISTS zurückgegeben. So vermeiden Sie doppelte Geräte:

  • Wenn Sie die deviceId des vorhandenen Geräts kennen, rufen Sie devices.get auf, um sie abzurufen.
  • Wenn du die deviceId nicht kennst, rufe devices.delete mit der requestId auf, um das verwaiste Gerät zu entfernen, bevor du diese Methode noch einmal ausprobierst.

Sie können bis zu 100 Geräte pro Nutzer Ihrer App erstellen. Wird dieses Limit überschritten, wird der Fehler RESOURCE_EXHAUSTED zurückgegeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
requestId

string

Optional. Eine vom Kunden bereitgestellte eindeutige Kennung für diese Anfrage. So wird die Ressourcenduplizierung bei einem Netzwerkausfall vermieden.

Diese ID muss das Format eines UUID-Strings (Version 4) haben und den folgenden Anforderungen entsprechen:

  • Es dürfen keine vertraulichen Informationen zur Identifizierung des Nutzers enthalten sein.
  • Muss 32 Hexadezimalzeichen enthalten, die in fünf Gruppen unterteilt und durch Bindestriche getrennt sind, im Format „xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx“ (oder 8-4-4-4-12).

Anfragetext

Der Anfragetext enthält eine Instanz von AmbientDevice.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von AmbientDevice.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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