Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.
User
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2026-09-29 UTC.
[null,null,["Ultimo aggiornamento 2026-09-29 UTC."],[],["The JSON representation defines a user with fields including `name` (resource identifier), `displayName` (user's name), `domainId` (Google Workspace domain), `type` (user or bot), and `isAnonymous` (deleted/hidden profile status). The `name` field uses aliases like email or People API ID. User types include `HUMAN` and `BOT`. Authenticated Chat app users only show `name` and `type` in request outputs. `type` is an enum with possible values like `HUMAN` and `BOT`.\n"]]