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

# Airtable 統合
<a name="airtable-integration"></a>

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

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

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

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

統合を設定する前に、以下があることを確認してください。
+ 使用するベースとデータにアクセスできるアクティブな Airtable アカウント。
+ **カスタム OAuth アプリ**の場合: [Airtable ウェブサイトの Airtable Builder Hub](https://airtable.com/create/oauth) にアクセスして OAuth 統合を登録します。
+ **API キー**の場合: [Airtable ウェブサイトの Airtable Builder Hub ](https://airtable.com/create/tokens)からの個人用アクセストークン。
+ Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## Airtable の設定
<a name="airtable-source-setup"></a>

**デフォルトの OAuth アプリ**認証を使用している場合は、このセクションをスキップして に進みます[Amazon Quick でのコネクタのセットアップ](#airtable-quicksuite-setup)。

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

### OAuth 統合を登録する (カスタム OAuth アプリ)
<a name="airtable-register-oauth"></a>

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

1. [Airtable ウェブサイトの Airtable Builder Hub](https://airtable.com/create/oauth) にサインインし、**OAuth 統合**を選択します。

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

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

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

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

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

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

1. **スコープ**で、統合に必要なアクセス許可を選択します。推奨されるスコープの完全なリストについては、「」を参照してください[推奨されるスコープ](#airtable-oauth-scopes)。

### 個人用アクセストークンを作成する (API キー)
<a name="airtable-create-pat"></a>

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

1. [Airtable ウェブサイトの Airtable Builder Hub](https://airtable.com/create/tokens) にサインインし、**個人用アクセストークン**を選択します。

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

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

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

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

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 でのコネクタのセットアップ
<a name="airtable-quicksuite-setup"></a>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   1. **API キー**の場合は、次のフィールドを設定します。
      + **ベース URL** (オプション) – Airtable API ベース URL。例: `https://api.airtable.com`
      + **API キー** – Airtable 個人用アクセストークン。
      + **E** メール (オプション) – Airtable アカウントに関連付けられている E メールアドレス。

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

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

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

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

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

## 使用可能なアクション
<a name="airtable-integration-actions"></a>

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


**空いている使用可能なアクション**  

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

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

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

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

### 認証問題
<a name="airtable-troubleshooting-auth"></a>
+ **サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ)** – Airtable アカウントがアクティブであり、Airtable ウェブサイトで [airtable.com](https://airtable.com) に直接サインインできることを確認します。カスタム OAuth アプリの場合、Airtable OAuth 統合のリダイレクト URL が Amazon Quick コールバック URL と一致することを確認します。
+ **無効なクライアント認証情報 (カスタム OAuth アプリ)** – クライアント ID とクライアントシークレットが Airtable OAuth 統合の値と一致していることを確認します。クライアントシークレットを再生成した場合は、Amazon Quick の値を更新します。
+ **API キーが拒否**されました – 個人用アクセストークンがアクティブで、必要なスコープがあることを確認します。トークンは Airtable Builder Hub で取り消すか、期限切れにすることができます。
+ **アクセス許可が不十分** – 認証方法用に設定されたスコープに、使用するアクションに必要なアクセス許可が含まれていることを確認します。「[推奨されるスコープ](#airtable-oauth-scopes)」を参照してください。