翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Google Docs の統合
<a name="google-docs-integration"></a>

Google Docs アクションコネクタを使用すると、自然言語を通じて Amazon Quick で Google Docs に直接アクセスできます。Amazon Quick を離れることなく、ドキュメントの作成と編集、コンテンツの読み取り、テキストとイメージの挿入、ドキュメント構造の管理を行うことができます。

Amazon Quick は、Google Docs の複数の認証方法をサポートしています。組織のセキュリティ要件に最適な方法を選択します。
+ **デフォルトの OAuth アプリケーション** – AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。Google アカウントで直接認証します。
+ **カスタム OAuth アプリ** – Google クラウドコンソールで作成されたカスタマー管理の OAuth クライアントを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## [開始する前に]
<a name="google-docs-integration-prerequisites"></a>

統合を設定する前に、以下があることを確認してください。
+ Google Docs にアクセスできる Google アカウント。
+ **カスタム OAuth アプリ**の場合: OAuth クライアントを作成するアクセス許可を持つ Google ウェブサイトの Google [クラウドコンソール](https://console.cloud.google.com/)にアクセスします。
+ Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## Google クラウドの設定
<a name="google-docs-source-setup"></a>

**デフォルトの OAuth アプリ**認証を使用する場合は、このセクションをスキップして「」を参照してください[Amazon Quick でのコネクタのセットアップ](#google-docs-quicksuite-setup)。

カスタム OAuth アプリ認証の場合は、Amazon Quick を設定する前に Google クラウドコンソールで次の手順を実行します。ステップ 3 で API を有効にする場合は、**Google Docs API **を検索して有効にします。

### Google クラウドコンソールで OAuth クライアントを作成する
<a name="w2aac49c28c69c13b7"></a>

Google クラウドコンソールで OAuth クライアントを作成して、Amazon Quick に必要なクライアント認証情報を取得します。詳細については、Google ウェブサイトの[OAuth 2.0 を使用して Google APIs](https://developers.google.com/identity/protocols/oauth2)」を参照してください。

1. Google ウェブサイトの [Google クラウドコンソール](https://console.cloud.google.com/)にサインインします。

1. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。

1. 左側のナビゲーションペインで、**APIsとサービス**を選択し、**ライブラリ**を選択します。統合に必要な API を検索し、**有効化**を選択します。

1. **OAuth 同意画面**を選択し、**開始**方法を選択します。

1. 同意画面を設定します。
   + **アプリ名**を入力し、**ユーザーサポート E** メールを選択します。
   + **対象者**には、**内部** (組織のみ) または**外部** (任意の Google ユーザー) を選択します。
   + 開発者の連絡先の詳細を追加し、**作成**を選択します。

1. **OAuth クライアントの作成**を選択します。

1. クライアントを設定します。
   + **アプリケーションタイプ**で、**ウェブアプリケーション**を選択します。
   + クライアント**の名前**を入力します。
   + **承認されたリダイレクト URIs**で、Amazon Quick コールバック URL を追加します。 `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. **[作成]** を選択します。

1. 次の値を記録します。Amazon Quick を設定するときに必要になります。
   + **クライアント ID**
   + **クライアントシークレット**

### 推奨されるスコープ
<a name="google-docs-oauth-scopes"></a>

Google Docs に接続すると、次のスコープがリクエストされます。


**Google Docs の推奨スコープ**  

| スコープ | 説明 | 
| --- | --- | 
| https://www.googleapis.com/auth/documents | Google Docs ドキュメントの読み取りと書き込みを行います。 | 
| https://www.googleapis.com/auth/drive | Google Drive でファイルの読み取りと書き込みを行います。 | 
| https://www.googleapis.com/auth/drive.readonly | Google Drive でファイルを読み取ります。 | 
| openid | ユーザーの ID を認証します。 | 
| email | ユーザーの E メールアドレスを読み取ります。 | 

**注記**  
`openid` および `email`スコープは、ユーザー認証の OAuth 同意フローに自動的に含まれます。Service-to-Service OAuth には必要ありません。

## Amazon Quick でのコネクタのセットアップ
<a name="google-docs-quicksuite-setup"></a>

### 使用可能なタブから接続する
<a name="google-docs-quick-connect"></a>

デフォルトの OAuth アプリ認証を使用する場合は、追加設定なしで **Available** タブから直接接続できます。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **使用可能な**タブで、**Google Docs** を検索し、**Connect** を選択します。

1. Google サインインフローを完了し、リクエストされたアクセス許可を付与します。

代わりにカスタム OAuth アプリでコネクタを設定するには、以下で説明するように**チーム用に作成**タブを使用します。

### チームの作成タブから を作成する
<a name="google-docs-full-setup"></a>

必要な Google クラウド設定が完了したら、Amazon Quick でコネクタを作成します。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **チームの作成**タブを選択します。

1. **Google Docs** を検索して選択します。
**注記**  
Google Docs コネクタが既に存在する場合は、既存のコネクタとともにダイアログが表示されます。既存のコネクタを使用するには、コネクタを選択します。新しいものを作成するには、**「いいえ」を選択し、新しいものを作成します**。

1. コネクタ**の名前**を入力します。必要に応じて、 **\+ 説明**を追加 を選択して説明を追加します。

1. Connection **type** で、**Public network** を選択します。

1. **OAuth 設定では**、次のいずれかの認証方法を選択し、必須フィールドを設定します。

   1. **デフォルトの OAuth アプリ**の場合:

      追加の認証情報は必要ありません。**[次へ]** を選択して続行します。

   1. **カスタム OAuth アプリ**の場合は、次のフィールドを設定します。
      + **ベース URL** (オプション) — Google Docs API ベース URL。例: `https://docs.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-docs-integration-actions"></a>

コネクタを設定すると、次のアクションを使用できます。


**Google Docs で使用可能なアクション**  

| Category | [アクション] | 説明 | 
| --- | --- | --- | 
| ドキュメント | ドキュメントの取得 | ID でドキュメントを取得します。 | 
| ドキュメント | ドキュメントプレーンテキストの取得 | ドキュメントのプレーンテキストコンテンツを取得します。 | 
| ドキュメント | ドキュメントの検索 | ドキュメントを検索します。 | 
| ドキュメント | ドキュメントの作成 | 新しいドキュメントを作成します。 | 
| ドキュメント | ドキュメントのマークダウンを作成する | Markdown コンテンツから新しいドキュメントを作成します。 | 
| ドキュメント | ドキュメントのコピー | 既存のドキュメントのコピーを作成します。 | 
| ドキュメント | ドキュメントの更新 | 既存のドキュメントを更新します。 | 
| ドキュメント | ドキュメントのマークダウンを更新する | Markdown コンテンツを含むドキュメントを更新します。 | 
| ドキュメント | ドキュメントセクションの更新 | Markdown を使用してドキュメントの特定のセクションを更新します。 | 
| ドキュメント | ドキュメントスタイルを更新する | ドキュメントのスタイルを更新します。 | 
| ドキュメント | Pdf のエクスポート | ドキュメントを PDF ファイルとしてエクスポートします。 | 
| コンテンツ | テキストを挿入する | 指定された場所にテキストを挿入します。 | 
| コンテンツ | テキストの更新 | 指定されたテキストのすべての出現を置き換えます。 | 
| コンテンツ | コンテンツ範囲の削除 | 指定された範囲内のコンテンツを削除します。 | 
| コンテンツ | インラインイメージを挿入する | インラインイメージをドキュメントに挿入します。 | 
| コンテンツ | Create Table | テーブルをドキュメントに挿入します。 | 
| コンテンツ | 段落の箇条書きを作成する | 段落に箇条書きの書式を追加します。 | 
| コンテンツ | 名前付き範囲の作成 | ドキュメントに名前付き範囲を作成します。 | 
| コンテンツ | ページブレークの作成 | 改ページを挿入します。 | 
| 構造 | ヘッダーの作成 | ドキュメントにヘッダーを作成します。 | 
| 構造 | フッターの作成 | ドキュメントにフッターを作成します。 | 

**注記**  
使用できるアクションは、認証されたユーザーがアクセスできるドキュメントによって異なります。

## の管理とトラブルシューティング
<a name="google-docs-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### Google 認証の一般的な問題
<a name="w2aac49c28c69c19b5"></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 Docs 固有の問題
<a name="google-docs-troubleshooting-service"></a>
+ **Google Docs API が有効になっていない** – Google Docs API が **APIs & Services**, **Library** の Google クラウドプロジェクトで有効になっていることを確認します。