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

# Google 캘린더 통합
<a name="google-calendar-integration"></a>

Google Calendar 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 Google Calendar에 직접 액세스할 수 있습니다. Amazon Quick을 떠나지 않고도 이벤트를 생성 및 업데이트하고, 가용성을 확인하고, 일정을 관리하고, 참석자를 구성할 수 있습니다.

Amazon Quick은 Google 캘린더에 대해 여러 인증 방법을 지원합니다. 조직의 보안 요구 사항에 가장 적합한 방법을 선택합니다.
+ **기본 OAuth 앱** AWS- 관리형 OAuth 애플리케이션을 사용합니다. 추가 자격 증명은 필요하지 않습니다. Google 계정으로 직접 인증합니다.
+ **사용자 지정 OAuth 앱** - Google Cloud Console에서 생성된 고객 관리형 OAuth 클라이언트를 사용합니다. 이 옵션을 사용하면 조직에서 OAuth 구성을 완전히 제어할 수 있습니다.

Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md).

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

통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
+ Google 캘린더에 액세스할 수 있는 Google 계정입니다.
+ **사용자 지정 OAuth 앱**의 경우: OAuth 클라이언트를 생성할 수 있는 권한이 있는 Google 웹 사이트의 Google [Cloud Console](https://console.cloud.google.com/)에 액세스합니다.
+ Amazon Quick 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).

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

**기본 OAuth 앱** 인증을 사용하는 경우이 섹션을 건너뛰고 로 이동합니다[Amazon Quick에서 커넥터 설정](#google-calendar-quicksuite-setup).

사용자 지정 OAuth 앱 인증의 경우 Amazon Quick을 구성하기 전에 Google Cloud 콘솔에서 다음 단계를 완료합니다. 3단계에서 API를 활성화할 때 **Google Calendar API**를 검색하고 활성화합니다.

### Google Cloud Console에서 OAuth 클라이언트 생성
<a name="w2aac49c28c65c13b7"></a>

Google Cloud Console에서 OAuth 클라이언트를 생성하여 Amazon Quick에 필요한 클라이언트 자격 증명을 가져옵니다. 자세한 내용은 Google 웹 사이트에서 [ OAuth 2.0을 사용하여 Google APIs](https://developers.google.com/identity/protocols/oauth2).

1. [Google 웹 사이트에서 Google Cloud Console](https://console.cloud.google.com/)에 로그인합니다.

1. 새 프로젝트를 생성하거나 기존 프로젝트를 선택합니다.

1. 왼쪽 탐색 창에서 **APIs 및 서비스를** 선택한 다음 **라이브러리**를 선택합니다. 통합에 필요한 API를 검색하고 **활성화**를 선택합니다.

1. **OAuth 동의 화면을** 선택하고 **시작하기를** 선택합니다.

1. 동의 화면을 구성합니다.
   + **앱 이름을** 입력하고 **사용자 지원 이메일을** 선택합니다.
   + **대상**에서 **내부**(조직만 해당) 또는 **외부**(모든 Google 사용자)를 선택합니다.
   + 개발자 연락처 세부 정보를 추가하고 **생성을** 선택합니다.

1. **OAuth 클라이언트 생성을** 선택합니다.

1. 클라이언트를 구성합니다.
   + **애플리케이션 유형**에서 **웹 애플리케이션을** 선택합니다.
   + 클라이언트의 **이름을** 입력합니다.
   + **승인된 리디렉션 URIs**에서 Amazon Quick 콜백 URL을 추가합니다. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` 

1. **생성(Create)**을 선택합니다.

1. 다음 값을 기록합니다. Amazon Quick을 구성할 때 필요합니다.
   + **클라이언트 ID**
   + **클라이언트 보안 암호(client secret)**

### 권장 범위
<a name="google-calendar-oauth-scopes"></a>

Google 캘린더에 연결할 때 다음 범위가 요청됩니다.


**Google 캘린더 권장 범위**  

| Scope | 설명 | 
| --- | --- | 
| https://www.googleapis.com/auth/calendar | 일정 이벤트 및 설정을 읽고 씁니다. | 
| openid | 사용자의 자격 증명을 인증합니다. | 
| email | 사용자의 이메일 주소를 읽습니다. | 

**참고**  
`openid` 및 `email` 범위는 사용자 인증을 위한 OAuth 동의 흐름에 자동으로 포함됩니다. Service-to-Service OAuth에는 필요하지 않습니다.

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

### 사용 가능 탭에서 연결
<a name="google-calendar-quick-connect"></a>

기본 OAuth 앱 인증을 사용하려면 추가 구성 없이 **사용 가능** 탭에서 직접 연결할 수 있습니다.

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

1. **사용 가능** 탭에서 **Google 캘린더**를 찾아 **연결을** 선택합니다.

1. Google 로그인 흐름을 완료하고 요청된 권한을 부여합니다.

대신 사용자 지정 OAuth 앱으로 커넥터를 구성하려면 아래 설명과 같이 **팀에 대해 생성** 탭을 사용합니다.

### 팀에 대해 생성 탭에서 생성
<a name="google-calendar-full-setup"></a>

필요한 Google Cloud 구성을 완료한 후 Amazon Quick에서 커넥터를 생성합니다.

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

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

1. **Google 캘린더**를 찾아 선택합니다.
**참고**  
Google Calendar 커넥터가 이미 있는 경우 기존 커넥터와 함께 대화 상자가 나타납니다. 기존 커넥터를 사용하려면 선택합니다. 새로 생성하려면 **아니요, 새로 생성을** 선택합니다.

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

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

1. **OAuth 구성**에서 다음 인증 방법 중 하나를 선택하고 필수 필드를 구성합니다.

   1. **기본 OAuth 앱**의 경우:

      추가 자격 증명은 필요하지 않습니다. **다음**을 선택하여 계속 진행합니다.

   1. **사용자 지정 OAuth 앱**의 경우 다음 필드를 구성합니다.
      + **기본 URL**(선택 사항) - Google Calendar API 기본 URL입니다. 예시: `https://www.googleapis.com/calendar`
      + **클라이언트 ID** - Google Cloud OAuth 클라이언트의 클라이언트 ID입니다.
      + **클라이언트 보안 암호** - Google Cloud OAuth 클라이언트의 클라이언트 보안 암호입니다.
      + **토큰 URL** - 토큰 엔드포인트입니다. 예시: `https://oauth2.googleapis.com/token`
      + **권한 부여 URL** - 권한 부여 엔드포인트입니다. 예시: `https://accounts.google.com/o/oauth2/v2/auth`
      + **리디렉션 URL** - Amazon Quick 콜백 URL로 미리 채워집니다.

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

1. **기본 OAuth 앱** 또는 **사용자 지정 OAuth 앱을** 선택한 경우 Google 권한 부여 창이 열립니다. 요청된 권한을 검토하고 **허용**을 선택합니다.

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

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

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

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

커넥터를 설정한 후 다음 작업을 사용할 수 있습니다.


**Google 캘린더 사용 가능한 작업**  

| 카테고리 | 작업 | 설명 | 
| --- | --- | --- | 
| 이벤트 | 이벤트 나열 | 일정의 이벤트를 나열합니다. | 
| 이벤트 | 이벤트 검색 | 키워드 또는 기준별로 이벤트를 검색합니다. | 
| 이벤트 | 이벤트 가져오기 | 특정 이벤트에 대한 세부 정보를 검색합니다. | 
| 이벤트 | 이벤트 생성 | 새 일정 이벤트를 생성합니다. | 
| 이벤트 | 빠른 이벤트 생성 | 텍스트 문자열에서 이벤트를 생성합니다. | 
| 이벤트 | 업데이트 이벤트 | 기존 이벤트를 업데이트합니다. | 
| 이벤트 | 이벤트 일정 업데이트 | 이벤트를 다른 일정으로 이동합니다. | 
| 이벤트 | 이벤트 가져오기 | 이벤트를 일정으로 가져옵니다. | 
| 이벤트 | 이벤트 인스턴스 나열 | 반복 이벤트의 인스턴스를 나열합니다. | 
| 이벤트 | 참석자 삭제 | 이벤트에서 참석자를 제거합니다. | 
| 가용성 | 프리 슬롯 나열 | 일정에서 사용 가능한 시간 슬롯을 찾습니다. | 
| 일정 | 일정 나열 | 인증된 사용자의 일정을 나열합니다. | 
| 일정 | 일정 이벤트 나열 | 모든 일정의 이벤트를 나열합니다. | 
| 일정 | 일정 가져오기 | 특정 일정에 대한 세부 정보를 검색합니다. | 
| 일정 | 일정 목록 가져오기 | 일정 목록 항목을 검색합니다. | 
| 일정 | 일정 목록 업데이트 | 일정 목록 항목을 업데이트합니다. | 
| Settings | 목록 설정 | 사용자의 일정 설정을 나열합니다. | 
| 유틸리티 | 현재 날짜 시간 가져오기 | 현재 날짜 및 시간을 검색합니다. | 

**참고**  
사용할 수 있는 작업은 인증된 사용자가 액세스할 수 있는 일정에 따라 다릅니다.

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

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

### 일반적인 Google 인증 문제
<a name="w2aac49c28c65c19b5"></a>
+ **로그인 실패(기본 OAuth 앱 또는 사용자 지정 OAuth 앱)** - Google 계정이 활성 상태이고 [Google 웹 사이트에](https://accounts.google.com) 직접 로그인할 수 있는지 확인합니다. 사용자 지정 OAuth 앱의 경우 Google Cloud OAuth 클라이언트의 리디렉션 URI가 Amazon Quick 콜백 URL과 일치하는지 확인합니다.
+ **관리자가 차단한 앱** - Google Workspace 관리자가 타사 앱 액세스를 제한하는 경우 로그인을 시도할 때 오류가 표시될 수 있습니다. Amazon Quick 앱을 허용하려면 Google Workspace 관리자에게 문의하세요.
+ **잘못된 클라이언트 자격 증명(사용자 지정 OAuth 앱)** - 클라이언트 ID와 클라이언트 보안 암호가 Google Cloud OAuth 클라이언트의 값과 일치하는지 확인합니다.
+ **인증 팝업 실패** - 브라우저가 Amazon Quick 콘솔 도메인의 팝업을 허용하는지 확인합니다. 다른 브라우저를 사용하거나 브라우저 캐시를 지우십시오.
+ **권한 취소 **- 이전에 Google 계정 권한 설정에서 Amazon Quick 액세스를 취소한 경우 커넥터를 편집하고 다시 로그인하여 다시 인증해야 합니다.
+ **Google API 속도 제한 **- Google은 사용량이 많은 기간 동안 요청을 제한할 수 있습니다. 작업이 실패하면 몇 분 후에 다시 시도하세요.

### Google 캘린더 관련 문제
<a name="google-calendar-troubleshooting-service"></a>
+ **Google 캘린더 API가 활성화되지** 않음 - Google 캘린더 API가 **APIs 및 서비스**, **라이브러리**의 Google 클라우드 프로젝트에서 활성화되어 있는지 확인합니다.