Method: users.availability.get

Restituisce informazioni sulla disponibilità di un utente umano in Google Chat. Ad esempio, può essere utilizzato per verificare se un utente è online o assente o per recuperare il suo messaggio di stato personalizzato.

Questo metodo recupera solo la disponibilità dell'utente autenticato.

Richiede l'autenticazione dell'utente con uno dei seguenti ambiti di autorizzazione:

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

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della risorsa della disponibilità da recuperare.

Formato: users/{user}/availability

{user} è l'ID della persona nell'API People o nell'API Directory dell'SDK Admin. Ad esempio, users/123456789.

L'indirizzo email dell'utente o me può essere utilizzato anche come alias per fare riferimento al chiamante. Ad esempio, users/user@example.com o users/me.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Availability.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la guida all'autorizzazione.