Method: users.availability.patch

Aktualisiert die Verfügbarkeitsinformationen für einen menschlichen Nutzer. Mit dieser Methode kann nur das Feld customStatus aktualisiert werden.

Mit dieser Methode wird nur die Verfügbarkeit des authentifizierten Nutzers aktualisiert.

Erfordert Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

  • https://www.googleapis.com/auth/chat.users.availability

HTTP-Anfrage

PATCH https://chat.googleapis.com/v1/{availability.name=users/*/availability}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
availability.name

string

ID. Ressourcenname der Verfügbarkeit des Nutzers.

Format: users/{user}/availability

{user} ist die ID für die Person in der People API oder Admin SDK Directory API. Beispiel: users/123456789.

Die E-Mail-Adresse des Nutzers oder me kann auch als Alias verwendet werden, um sich auf den Anrufer zu beziehen. Beispiel: users/user@example.comoder users/me

Suchparameter

Parameter
updateMask

string (FieldMask format)

Erforderlich. Die Liste der zu aktualisierenden Felder. Das einzige Feld, das aktualisiert werden kann, ist customStatus.

Anfragetext

Der Anfragetext enthält eine Instanz von Availability.

Antworttext

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.users.availability

Weitere Informationen finden Sie im Autorisierungsleitfaden.