View a markdown version of this page

Airtable 統合 - Amazon Quick

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

Airtable 統合

Airtable アクションコネクタを使用すると、自然言語を通じて Amazon Quick で Airtable プラットフォームに直接アクセスできます。Amazon Quick を離れることなく、レコードの作成と更新、ベースとテーブルの管理、ビューのフィルタリング、リレーショナルデータオペレーションを実行できます。

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

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

  • カスタム OAuth アプリ – Airtable に登録されたカスタマー管理の OAuth アプリケーションを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。

  • API キー – 認証に Airtable 個人用アクセストークンを使用します。個々の使用またはテストに適しています。

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

[開始する前に]

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

Airtable の設定

デフォルトの OAuth アプリ認証を使用している場合は、このセクションをスキップして に進みますAmazon Quick でのコネクタのセットアップ

カスタム OAuth アプリまたは API キー認証の場合は、Amazon Quick を設定する前に Airtable で該当するステップを完了してください。

OAuth 統合を登録する (カスタム OAuth アプリ)

Airtable Builder Hub で OAuth 統合を作成して、Amazon Quick に必要なクライアント認証情報を取得します。

  1. Airtable ウェブサイトの Airtable Builder Hub にサインインし、OAuth 統合を選択します。

  2. 新しい OAuth 統合の登録 を選択します。

  3. 統合の名前を入力します。

  4. OAuth リダイレクト URLs、Amazon Quick からのリダイレクト URL を入力します。 https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  5. 統合の登録を選択します。

  6. 登録後、クライアントシークレットを再生成を選択してクライアントシークレットを生成します。

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

    • クライアント ID

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

  8. スコープで、統合に必要なアクセス許可を選択します。推奨されるスコープの完全なリストについては、「」を参照してください推奨されるスコープ

個人用アクセストークンを作成する (API キー)

API キー認証用の Airtable Builder Hub で個人用アクセストークンを作成します。

  1. Airtable ウェブサイトの Airtable Builder Hub にサインインし、個人用アクセストークンを選択します。

  2. [トークンを作成] をクリックします。

  3. ユースケースに応じて、トークン名、スコープ、ベースアクセスを設定します。

  4. 生成されたトークンをコピーして安全に保存します。Amazon Quick を設定するときに必要になります。

推奨されるスコープ

OAuth 統合を登録するとき、または個人用アクセストークンを作成するときは、使用するアクションに基づいて以下のスコープを設定します。

飛行可能な推奨スコープ
スコープ 説明
data.records:read レコード内のデータを読み取ります。
data.records:write レコードを作成、編集、削除します。
data.recordComments:read レコード内のコメントを読み取ります。
data.recordComments:write レコードコメントを作成、編集、削除します。
schema.bases:read テーブル名やフィールドタイプなど、基本の構造を読み取ります。
schema.bases:write テーブル名やフィールドタイプなど、ベースの構造を編集します。
user.email:read 認証されたユーザーの E メールアドレスを読みます。

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

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

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

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

  2. Available タブで、Airtable を見つけて Connect を選択します。

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

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

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

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

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

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

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

    注記

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

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

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

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

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

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

    2. カスタム OAuth アプリの場合は、次のフィールドを設定します。

      • ベース URL (オプション) – Airtable API ベース URL。例: https://api.airtable.com

      • クライアント ID – Airtable OAuth 統合のクライアント ID。

      • クライアントシークレット – Airtable OAuth 統合からのクライアントシークレット。

      • トークン URL – トークンエンドポイント。例: https://airtable.com/oauth2/v1/token

      • 認可 URL – 認可エンドポイント。例: https://airtable.com/oauth2/v1/authorize

      • リダイレクト URL – Amazon Quick コールバック URL があらかじめ入力されています。

    3. API キーの場合は、次のフィールドを設定します。

      • ベース URL (オプション) – Airtable API ベース URL。例: https://api.airtable.com

      • API キー – Airtable 個人用アクセストークン。

      • E メール (オプション) – Airtable アカウントに関連付けられている E メールアドレス。

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

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

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

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

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

使用可能なアクション

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

空いている使用可能なアクション
Category [アクション] 説明
レコード レコードを一覧表示する オプションのフィルタリングとソートを使用して、テーブル内のレコードを一覧表示します。
レコード レコードの取得 ID で特定のレコードを取得します。
レコード レコードのバッチ作成 テーブルに 1 つ以上の新しいレコードを作成します。
レコード レコードの更新 既存のレコードのフィールドを更新します。
レコード バッチ更新レコード PATCH を使用して 1 回のオペレーションで複数のレコードを更新します。
レコード バッチプットレコード PUT を使用して 1 回のオペレーションで複数のレコードをアップサートします。
コメント コメントを一覧表示する レコードに関するコメントを一覧表示します。
コメント コメントの作成 レコードにコメントを追加します。
コメント コメントの更新 レコードの既存のコメントを編集します。
Schema ベースを一覧表示する 認証されたユーザーがアクセスできるすべてのベースを一覧表示します。
Schema ベーススキーマの取得 テーブルとフィールド定義を含む、基本のスキーマを取得します。
Schema Create Table ベースに新しいテーブルを作成します。
Schema Update Table 名前や説明などのテーブルプロパティを更新します。
Schema フィールドの作成 テーブルに新しいフィールドを追加します。
Schema 更新フィールド 名前やタイプなどのフィールドプロパティを更新します。
アタッチメント 添付ファイルの作成 添付ファイルをレコードにアップロードします。
[ユーザー] ユーザー情報の取得 認証されたユーザーに関する情報を取得します。
注記

使用できるアクションは、認証されたユーザーがアクセスできるベースとワークスペースによって異なります。

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

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

認証問題

  • サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ) – Airtable アカウントがアクティブであり、Airtable ウェブサイトで airtable.com に直接サインインできることを確認します。カスタム OAuth アプリの場合、Airtable OAuth 統合のリダイレクト URL が Amazon Quick コールバック URL と一致することを確認します。

  • 無効なクライアント認証情報 (カスタム OAuth アプリ) – クライアント ID とクライアントシークレットが Airtable OAuth 統合の値と一致していることを確認します。クライアントシークレットを再生成した場合は、Amazon Quick の値を更新します。

  • API キーが拒否されました – 個人用アクセストークンがアクティブで、必要なスコープがあることを確認します。トークンは Airtable Builder Hub で取り消すか、期限切れにすることができます。

  • アクセス許可が不十分 – 認証方法用に設定されたスコープに、使用するアクションに必要なアクセス許可が含まれていることを確認します。「推奨されるスコープ」を参照してください。