기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Google Chat 통합
<a name="google-chat-integration"></a>

Google Chat 작업 커넥터를 사용하면 Google Workspace 계정에서 자연어를 통해 Amazon Quick로 직접 메시지를 보내고, 스페이스를 관리하고, 채팅 스레드와 상호 작용할 수 있습니다.

Google Chat은 사용자 지정 OAuth 앱 인증을 사용합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md).

## 시작하기 전 준비 사항
<a name="google-chat-prerequisites"></a>

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
+ 사용하려는 Google Chat 스페이스에 액세스할 수 있는 활성 Google Workspace 계정입니다.
+ Google Chat API가 활성화된 상태에서 Google Workspace 프로젝트를 위해 Google Cloud 콘솔에 등록된 OAuth 2.0 클라이언트입니다.
+ Amazon Quick 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).

## Google Cloud 구성
<a name="google-chat-source-setup"></a>

사용자 지정 OAuth 앱 인증의 경우 [Google Cloud 콘솔](https://console.cloud.google.com/)에서 OAuth 2.0 클라이언트를 생성하고, 프로젝트에 Google Chat API를 활성화하고, 필요한 채팅 범위(예: , `chat.spaces`)로 OAuth 동의 화면을 구성하고`chat.messages`, Amazon Quick 콜백 URL을 승인된 리디렉션 URI`https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`로 추가합니다. {{{region}}}을 해당AWS리전(예: `us-east-1`)으로 바꿉니다. step-by-step 지침은 [Google Workspace 개발자 설명서의 Google Chat API](https://developers.google.com/workspace/chat)를 참조하세요. 클라이언트 ID 및 클라이언트 보안 암호 기록 - Amazon Quick을 구성할 때 필요합니다.

## Amazon Quick에서 커넥터 설정
<a name="google-chat-quicksuite-setup"></a>

1. Amazon Quick 콘솔에서 **커넥터를** 선택합니다.

1. **팀에 대해 생성** 탭을 선택합니다.

1. **Google Chat**을 찾아 선택합니다.

1. 커넥터의 **이름을** 입력합니다. 선택적으로 **\+ 설명 추가**를 선택하여 설명을 추가합니다.

1. **연결 유형**에서 **퍼블릭 네트워크를** 선택합니다.

1. **OAuth 구성**에서 **사용자 지정 OAuth 앱을** 선택하고 다음 필드를 구성합니다.
   + **기본 URL** - Google Chat MCP 기본 URL입니다.
   + **클라이언트 ID** - Google Cloud OAuth 2.0 클라이언트의 OAuth 클라이언트 ID입니다.
   + **퍼블릭 OAuth 클라이언트**(선택 사항) - Google Cloud OAuth 2.0 클라이언트가 퍼블릭 클라이언트로 구성된 경우(클라이언트 보안 암호 없음)이 옵션을 선택합니다.
   + **클라이언트 보안 암호** - Google Cloud OAuth 2.0 클라이언트의 클라이언트 보안 암호입니다.
   + **토큰 URL** - Google OAuth 토큰 엔드포인트입니다.
   + **권한 부여 URL** - Google OAuth 권한 부여 엔드포인트입니다.
   + **리디렉션 URL** - Amazon Quick 콜백 URL로 미리 채워집니다.

1. **다음**을 선택합니다.

1. Google 로그인 창이 열립니다. 요청된 권한을 검토하고 **허용**을 선택합니다.

1. **검토** 페이지에서 커넥터에 사용할 수 있는 작업을 검토합니다. **다음**을 선택합니다.

1. **게시** 페이지에서 커넥터에 액세스할 수 있는 사용자를 선택합니다. 조직의 모든 사람에 대해 액세스를 활성화하거나 특정 팀 또는 그룹을 검색할 수 있습니다.

1. **게시**를 선택합니다.

## 사용 가능한 작업
<a name="google-chat-actions"></a>

커넥터를 설정한 후 Google Chat에 표시되는 작업을 사용할 수 있습니다. 커넥터에 대한 현재 작업 세트를 보려면 Amazon Quick 콘솔에서 커넥터의 **사용 가능한 작업** 보기로 이동합니다.

## 관리 및 문제 해결
<a name="google-chat-troubleshooting"></a>

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).

### 인증 문제
<a name="google-chat-troubleshooting-auth"></a>
+ **로그인 실패 **- Google Workspace 계정이 활성 상태이고 Google Chat에 직접 로그인할 수 있는지 확인합니다. Google Cloud OAuth 2.0 클라이언트의 승인된 리디렉션 URI가 Amazon Quick 콜백 URL과 일치하는지 확인합니다.
+ **잘못된 클라이언트 자격 증명** - 클라이언트 ID와 클라이언트 보안 암호가 Google Cloud OAuth 2.0 클라이언트의 값과 일치하는지 확인합니다.
+ **권한 부족 **- 채팅 API가 활성화되어 있고 OAuth 동의 화면에 사용하려는 작업에 필요한 범위가 포함되어 있는지 확인합니다.