Google Sheets の統合

Google Sheets アクションコネクタを使用すると、自然言語を通じて Amazon Quick で Google Sheets に直接アクセスできます。Amazon Quick を離れることなく、スプレッドシートの作成と編集、セル範囲の読み取りと書き込み、セルのフォーマット、データの検索を行うことができます。

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

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

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

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

[開始する前に]

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

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

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

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

Google クラウドの設定

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

カスタム OAuth アプリ認証の場合は、Amazon Quick を設定する前に Google クラウドコンソールで次の手順を実行します。ステップ 3 で API を有効にする場合は、Google Sheets 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 Sheets に接続すると、次のスコープがリクエストされます。

Google Sheets の推奨スコープ

スコープ	説明
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	ユーザーの ID を認証します。
email	ユーザーの E メールアドレスを読み取ります。

注記

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

Amazon Quick でのコネクタのセットアップ

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

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

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

2. Available タブで、Google Sheets を検索し、Connect を選択します。

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

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

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

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

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

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

3. Google シートを検索して選択します。

   注記

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

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

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

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

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

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

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

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

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

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

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

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

使用可能なアクション

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

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

Category	[アクション]	説明
値	値の取得	セル範囲から値を読み取ります。
値	バッチ取得値	1 つのリクエストで複数のセル範囲から値を読み取ります。
値	フィルタで値を取得する	データフィルターを使用して値を読み取ります。
値	値の更新	セル範囲に値を書き込みます。
値	バッチ更新値	1 つのリクエストで複数のセル範囲に値を書き込みます。
値	値の追加	範囲内のデータの最終行の後に値を追加します。
値	値の削除	セル範囲から値をクリアします。
値	テキストの更新	スプレッドシート全体でテキストを検索して置き換えます。
[Rows] (行)	行の作成	スプレッドシートに新しい行を作成します。
[Rows] (行)	行の配置	スプレッドシートの行をアップサートします。
[Rows] (行)	スプレッドシート行の取得	条件を一致させて行を検索します。
スプレッドシート	スプレッドシートの作成	新しいスプレッドシートを作成します。
スプレッドシート	スプレッドシート情報の取得	スプレッドシートのメタデータを取得します。
スプレッドシート	スプレッドシートの検索	スプレッドシートを検索します。
シート	シートの作成	スプレッドシートに新しいシートを追加します。
シート	シート名を一覧表示する	スプレッドシート内のシート名を一覧表示します。
シート	シートのプロパティを更新する	名前や可視性などのシートプロパティを更新します。
フォーマット	セル形式を更新する	範囲内のセルをフォーマットします。
フォーマット	条件付き形式のルールを更新する	条件付き書式設定ルールを作成または更新します。

注記

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

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

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

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 Sheets 固有の問題

• Google Sheets API が有効になっていない – Google Sheets API が APIs とサービス、ライブラリの Google クラウドプロジェクトで有効になっていることを確認します。