Method: projects.locations.apps.assistantSessions.cancelAssistantTurn

어시스턴트 세션의 진행 중인 차례를 취소합니다(있는 경우). 스트림과 분리되어 실행 중인 차례에 대한 명시적인 사용자 중지입니다. 차례를 호스팅하지 않는 태스크에 대한 취소는 세션 차례 에포크를 통해 선점하여 하나의 임대 갱신 내에서 종료합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 취소할 진행 중인 대화가 있는 어시스턴트 세션입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "turnId": string
}
필드
turnId

string

선택사항입니다. 취소할 차례입니다. 비어 있으면 실행 중인 차례가 취소됩니다. 더 이상 실행 중이 아닌 차례를 지정하는 취소는 작동하지 않습니다.

응답 본문

assistantSessions.cancelAssistantTurn에 대한 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "cancelled": boolean
}
필드
cancelled

boolean

실행 중인 차례가 발견되어 중지 요청을 받았는지 여부(이 태스크에서 직접 또는 다른 곳에서 호스팅되는 차례에 대한 에포크 선점을 통해)

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 Authentication Overview에서 확인하세요.

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • ces.assistantSessions.get

자세한 내용은 IAM 문서를 참조하세요.