Method: users.availability.get

Renvoie des informations sur la disponibilité d'un utilisateur humain dans Google Chat. Par exemple, vous pouvez vérifier si un utilisateur est en ligne ou absent, ou récupérer son message d'état personnalisé.

Cette méthode ne récupère que la disponibilité de l'utilisateur authentifié.

Nécessite l'authentification de l'utilisateur avec l'un des champs d'application d'autorisation suivants :

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de la disponibilité à récupérer.

Format: users/{user}/availability

{user} correspond à l'ID de la personne dans l'API People ou l'API Admin SDK Directory. Exemple : users/123456789.

L'adresse e-mail de l'utilisateur ou me peuvent également être utilisés comme alias pour faire référence à l'appelant. Exemple : users/user@example.com ou users/me.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Availability.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez le guide sur l'autorisation.