Method: devices.patch

Aktualisiert Informationen zum angegebenen Gerät.

Ein NOT_FOUND-Fehler wird zurückgegeben, wenn das Gerät nicht vorhanden ist oder nicht dem Nutzer gehört.

HTTP-Anfrage

PATCH https://photosambient.googleapis.com/v1/devices/{deviceId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
deviceId

string

Erforderlich. Die eindeutige Kennung für dieses Gerät.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Optional. Die Liste der zu aktualisierenden AmbientDevice-Felder.

Wenn Sie beispielsweise die displayName des Geräts aktualisieren möchten, muss der Feldpfad userSettings.displayName in der updateMask der Anfrage angegeben werden.

Mit dem Sonderwert * können Sie angeben, dass alle Felder (die aktualisiert werden können) aktualisiert werden sollen.

Wenn nichts angegeben ist, wird stattdessen eine implizite Feldmaske verwendet, die allen Feldern in device entspricht (d.h. einen nicht leeren Wert enthält).

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Anfragetext

Der Anfragetext enthält eine Instanz von AmbientDevice.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von AmbientDevice.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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