- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
Genera un token con ambito di sessione per il widget di chat per l'autenticazione con le API Session.
Richiesta HTTP
POST https://ces.googleapis.com/v1/{name=projects/*/locations/*/apps/*/sessions/*}:generateChatToken
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
name |
Obbligatorio. Il nome della sessione per cui generare il token di chat. Formato: projects/{project}/locations/{location}/apps/{app}/sessions/{session} |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
|---|
{ "deployment": string, "recaptchaToken": string, "liveHandoffEnabled": boolean } |
| Campi | |
|---|---|
deployment |
Obbligatorio. Il deployment dell'app da utilizzare per la sessione. Formato: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment} |
recaptchaToken |
Facoltativo. Il token reCAPTCHA generato dal widget di chat lato client. |
liveHandoffEnabled |
Facoltativo. Indica se il trasferimento live è abilitato per la sessione. |
Corpo della risposta
Messaggio di risposta per WidgetService.GenerateChatToken.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
|---|
{ "chatToken": string, "expireTime": string } |
| Campi | |
|---|---|
chatToken |
Il token con ambito di sessione per il widget di chat per l'autenticazione con le API Session. |
expireTime |
L'ora in cui scade il token di chat. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/ces
Per saperne di più, consulta la Authentication Overview.