Google Docs の統合

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

Amazon Quick は、Google Docs の複数の認証方法をサポートしています。組織のセキュリティ要件に最適な方法を選択します。

• デフォルトの OAuth アプリケーション – AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。Google アカウントで直接認証します。

• カスタム OAuth アプリ – Google クラウドコンソールで作成されたカスタマー管理の OAuth クライアントを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください認証方法。

[開始する前に]

統合を設定する前に、以下があることを確認してください。

• Google Docs にアクセスできる Google アカウント。

• カスタム OAuth アプリの場合: OAuth クライアントを作成するアクセス許可を持つ Google ウェブサイトの Google クラウドコンソールにアクセスします。

• Amazon Quick サブスクリプションの要件については、「」を参照してくださいコンソールで統合を設定する。

Google クラウドの設定

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

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

Google クラウドコンソールで OAuth クライアントを作成する

Google クラウドコンソールで OAuth クライアントを作成して、Amazon Quick に必要なクライアント認証情報を取得します。詳細については、Google ウェブサイトのOAuth 2.0 を使用して Google APIs」を参照してください。

1. Google ウェブサイトの Google クラウドコンソールにサインインします。

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

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

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

5. 同意画面を設定します。

   • アプリ名を入力し、ユーザーサポート E メールを選択します。

   • 対象者には、内部 (組織のみ) または外部 (任意の Google ユーザー) を選択します。

   • 開発者の連絡先の詳細を追加し、作成を選択します。

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

7. クライアントを設定します。

   • アプリケーションタイプで、ウェブアプリケーションを選択します。

   • クライアントの名前を入力します。

   • 承認されたリダイレクト URIsで、Amazon Quick コールバック URL を追加します。 https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

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

9. 次の値を記録します。Amazon Quick を設定するときに必要になります。

   • クライアント ID

   • クライアントシークレット

推奨されるスコープ

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 でのコネクタのセットアップ

使用可能なタブから接続する

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

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

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

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

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

チームの作成タブから を作成する

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

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

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

3. Google Docs を検索して選択します。

   注記

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

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

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

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

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

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

   2. カスタム 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 があらかじめ入力されています。

7. [次へ] を選択します。

8. デフォルトの OAuth アプリまたはカスタム OAuth アプリを選択した場合、Google 認可ウィンドウが開きます。リクエストされたアクセス許可を確認し、許可を選択します。

9. レビューページで、コネクタで使用可能なアクションを確認します。[次へ] を選択します。

10. 公開ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

11. [公開] を選択します。

使用可能なアクション

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

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

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

注記

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

の管理とトラブルシューティング

コネクタを編集、共有、または削除するには、「」を参照してください既存の統合の管理。

Google 認証の一般的な問題

• サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ) – Google アカウントがアクティブであり、Google ウェブサイトに直接サインインできることを確認します。カスタム 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 固有の問題

• Google Docs API が有効になっていない – Google Docs API が APIs & Services, Library の Google クラウドプロジェクトで有効になっていることを確認します。