Method: projects.locations.apps.assistantSessions.cancelAssistantTurn

Annulla il turno in corso della sessione dell'assistente, se presente: l'interruzione esplicita dell'utente per un turno in esecuzione scollegato da qualsiasi stream. Un annullamento che si verifica su un'attività che non ospita il turno lo prerilascia invece tramite l'epoca del turno della sessione, terminandolo entro un rinnovo del lease.

Richiesta HTTP

POST https://ces.googleapis.com/v1beta/{name=projects/*/locations/*/apps/*/assistantSessions/*}:cancelAssistantTurn

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
name

string

Obbligatorio. La sessione dell'assistente di cui annullare il turno in corso.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "turnId": string
}
Campi
turnId

string

Facoltativo. Il turno da annullare; se vuoto, annulla il turno in corso. Un annullamento che indica un turno che non è più quello in esecuzione non ha alcun effetto.

Corpo della risposta

Risposta per assistantSessions.cancelAssistantTurn.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "cancelled": boolean
}
Campi
cancelled

boolean

Indica se è stato trovato un turno in corso e se è stato chiesto di interromperlo (direttamente in questa attività o tramite una prelazione dell'epoca per un turno ospitato altrove).

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • ces.assistantSessions.get

Per saperne di più, consulta la documentazione di IAM.