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

# Google Sheets 통합
<a name="google-sheets-integration"></a>

Google Sheets 작업 커넥터를 사용하면 자연어를 통해 Amazon Quick에서 Google Sheets에 직접 액세스할 수 있습니다. Amazon Quick을 벗어나지 않고도 스프레드시트를 생성 및 편집하고, 셀 범위를 읽고 쓰고, 셀을 포맷하고, 데이터를 검색할 수 있습니다.

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

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

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

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

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

**기본 OAuth 앱** 인증을 사용하는 경우이 섹션을 건너뛰고 섹션을 참조하세요[Amazon Quick에서 커넥터 설정](#google-sheets-quicksuite-setup).

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

### Google Cloud Console에서 OAuth 클라이언트 생성
<a name="w2aac49c28c81c13b7"></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-sheets-oauth-scopes"></a>

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


**Google Sheets 권장 범위**  

| Scope | 설명 | 
| --- | --- | 
| https://www.googleapis.com/auth/spreadsheets | Google Sheets 스프레드시트를 읽고 씁니다. | 
| https://www.googleapis.com/auth/drive | Google Drive에서 파일을 읽고 씁니다. | 
| https://www.googleapis.com/auth/drive.readonly | Google Drive에서 파일을 읽습니다. | 
| openid | 사용자의 자격 증명을 인증합니다. | 
| email | 사용자의 이메일 주소를 읽습니다. | 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   1. **사용자 지정 OAuth 앱**의 경우 다음 필드를 구성합니다.
      + **기본 URL**(선택 사항) - Google Sheets API 기본 URL입니다. 예: `https://sheets.googleapis.com`
      + **클라이언트 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-sheets-integration-actions"></a>

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


**Google Sheets 사용 가능한 작업**  

| 카테고리 | 작업 | 설명 | 
| --- | --- | --- | 
| 값 | 값 가져오기 | 셀 범위에서 값을 읽습니다. | 
| 값 | 배치 가져오기 값 | 단일 요청으로 여러 셀 범위에서 값을 읽습니다. | 
| 값 | 필터로 값 가져오기 | 데이터 필터를 사용하여 값을 읽습니다. | 
| 값 | 값 업데이트 | 셀 범위에 값을 씁니다. | 
| 값 | 배치 업데이트 값 | 단일 요청으로 여러 셀 범위에 값을 씁니다. | 
| 값 | 값 추가 | 범위의 마지막 데이터 행 뒤에 값을 추가합니다. | 
| 값 | 값 삭제 | 셀 범위에서 값을 지웁니다. | 
| 값 | 텍스트 업데이트 | 스프레드시트에서 텍스트를 찾아 바꿉니다. | 
| 행 | 행 생성 | 스프레드시트에 새 행을 생성합니다. | 
| 행 | 행 넣기 | 스프레드시트의 행을 업서트합니다. | 
| 행 | 스프레드시트 행 가져오기 | 기준과 일치하는 행을 찾습니다. | 
| 스프레드시트 | 스프레드시트 생성 | 새 스프레드시트를 생성합니다. | 
| 스프레드시트 | 스프레드시트 정보 가져오기 | 스프레드시트의 메타데이터를 검색합니다. | 
| 스프레드시트 | 스프레드시트 검색 | 스프레드시트를 검색합니다. | 
| 시트 | 시트 생성 | 스프레드시트에 새 시트를 추가합니다. | 
| 시트 | 시트 이름 나열 | 스프레드시트에 시트 이름을 나열합니다. | 
| 시트 | 시트 속성 업데이트 | 이름 또는 가시성과 같은 시트 속성을 업데이트합니다. | 
| 형식 지정 | 셀 형식 업데이트 | 범위의 셀 형식을 지정합니다. | 
| 형식 지정 | 조건부 형식 규칙 업데이트 | 조건부 형식 지정 규칙을 생성하거나 업데이트합니다. | 

**참고**  
사용할 수 있는 작업은 인증된 사용자가 액세스할 수 있는 스프레드시트에 따라 다릅니다.

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

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

### 일반적인 Google 인증 문제
<a name="w2aac49c28c81c19b5"></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 Sheets 관련 문제
<a name="google-sheets-troubleshooting-service"></a>
+ **Google Sheets API가 활성화되지** 않음 - Google Sheets API가 **APIs 및 서비스**, **라이브러리**의 Google Cloud 프로젝트에서 활성화되어 있는지 확인합니다.