Method: users.availability.get

Muestra información de disponibilidad para un usuario humano en Google Chat. Por ejemplo, se puede usar para verificar si un usuario está en línea o ausente, o para recuperar su mensaje de estado personalizado.

Este método solo recupera la disponibilidad del usuario autenticado.

Requiere la autenticación del usuario con uno de los siguientes permisos de autorización:

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

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. El nombre del recurso de la disponibilidad que se recuperará.

Formato: users/{user}/availability

{user} es el ID de la persona en la API de People o la API de Directory del SDK de Admin. Por ejemplo, users/123456789.

La dirección de correo electrónico del usuario o me también se pueden usar como alias para hacer referencia a la persona que llama. Por ejemplo, users/user@example.com o users/me.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Availability.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta la guía de autorización.