Method: projects.locations.apps.sessions.generateChatToken

세션 API로 인증할 채팅 위젯의 세션 범위 토큰을 생성합니다.

HTTP 요청

POST https://ces.googleapis.com/v1/{name=projects/*/locations/*/apps/*/sessions/*}:generateChatToken

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

경로 매개변수

매개변수
name

string

필수 항목입니다. 채팅 토큰을 생성할 세션 이름입니다. 형식: projects/{project}/locations/{location}/apps/{app}/sessions/{session}

요청 본문

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

JSON 표현
{
  "deployment": string,
  "recaptchaToken": string,
  "liveHandoffEnabled": boolean
}
필드
deployment

string

필수 항목입니다. 세션에 사용할 앱의 배포입니다. 형식: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}

recaptchaToken

string

선택사항입니다. 클라이언트 측 채팅 위젯에서 생성된 reCAPTCHA 토큰입니다.

liveHandoffEnabled

boolean

선택사항입니다. 세션에 라이브 핸드오프가 사용 설정되어 있는지 나타냅니다.

응답 본문

WidgetService.GenerateChatToken의 응답 메시지입니다.

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

JSON 표현
{
  "chatToken": string,
  "expireTime": string
}
필드
chatToken

string

세션 API로 인증하기 위한 채팅 위젯의 세션 범위 토큰입니다.

expireTime

string (Timestamp format)

채팅 토큰이 만료되는 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

승인 범위

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

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

자세한 내용은 Authentication Overview를 참조하세요.