Method: users.availability.get

Gibt Verfügbarkeitsinformationen für einen menschlichen Nutzer in Google Chat zurück. So kann beispielsweise geprüft werden, ob ein Nutzer online oder abwesend ist, oder seine benutzerdefinierte Statusmeldung abgerufen werden.

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

Erfordert Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

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

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname der abzurufenden Verfügbarkeit.

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

Anfragetext

Der Anfragetext muss leer sein.

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
  • https://www.googleapis.com/auth/chat.users.availability.readonly

Weitere Informationen finden Sie im Autorisierungsleitfaden.