User

Un utente in Google Chat.

Se restituita come output di una richiesta, se la tua app di chat esegue l'autenticazione come utente, l'output per una risorsa User (ad esempio nelle API Messages e Memberships) compila solo i campi name e type per gli utenti interni ed esterni, a meno che non siano membri dello spazio o non abbiano affinità precedente con l'utente chiamante.

Rappresentazione JSON
{
  "name": string,
  "displayName": string,
  "avatarUrl": string,
  "email": string,
  "domainId": string,
  "type": enum (Type),
  "isAnonymous": boolean
}
Campi
name

string

Nome della risorsa per un user di Google Chat.

Formato: users/{user}. users/app può essere utilizzato come alias per l'utente dell'app di chiamata bot.

Per human users, {user} è lo stesso identificatore utente di:

  • id per la Persona nell'API People. Ad esempio, users/123456789 nell'API Chat rappresenta la stessa persona dell'ID profilo persona 123456789 nell'API People.

  • id per un utente nell'API Admin SDK Directory.

  • L'indirizzo email dell'utente può essere utilizzato come alias per {user} nelle richieste API. Ad esempio, se l'ID profilo persona dell'API People per user@example.com è 123456789, puoi utilizzare users/user@example.com come alias per fare riferimento a users/123456789. L'API restituirà solo il nome della risorsa canonica (ad esempio users/123456789).

displayName

string

Solo output. Il nome visualizzato dell'utente.

Compilato sia per l'autenticazione dell'app sia per l'autenticazione utente. Questo campo viene sempre compilato per le richieste effettuate con l'autenticazione dell'app. Quando chiami le API Messages e Memberships con l'autenticazione utente, questo campo viene compilato sia per gli utenti interni che per quelli esterni per il sender di un messaggio, per gli utenti all'interno di annotations (ad esempio le menzioni degli utenti) e all'interno delle risorse Membership, a condizione che l'utente sia membro dello spazio o abbia un'affinità precedente con l'utente chiamante.

avatarUrl

string

Solo output. L'URL dell'immagine dell'avatar dell'utente.

Quando chiami le API Messages e Memberships con l'autenticazione utente, questo campo viene compilato sia per gli utenti interni che per quelli esterni per il sender di un messaggio, per gli utenti all'interno di annotations (ad esempio le menzioni degli utenti) e all'interno delle risorse Membership, a condizione che l'utente sia membro dello spazio o abbia un'affinità precedente con l'utente chiamante.

email

string

Solo output. L'indirizzo email dell'utente.

Quando chiami le API Messages e Memberships con l'autenticazione utente, questo campo viene compilato sia per gli utenti interni che per quelli esterni per il sender di un messaggio, per gli utenti all'interno di annotations (ad esempio le menzioni degli utenti) e all'interno delle risorse Membership, a condizione che l'utente sia membro dello spazio o abbia un'affinità precedente con l'utente chiamante.

domainId

string

Identificatore univoco del dominio Google Workspace dell'utente.

type

enum (Type)

Tipo di utente.

isAnonymous

boolean

Solo output. Quando true, l'utente viene eliminato o il suo profilo non è visibile, ad esempio quando un utente viene menzionato in uno spazio senza essere membro e senza affinità precedente con l'utente chiamante.

Tipo

Enum
TYPE_UNSPECIFIED Valore predefinito per l'enum. NON UTILIZZARE.
HUMAN Utente umano.
BOT Utente dell'app di chat.