本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 金鑰身分驗證，請先完成 Airtable 中的適用步驟，再設定 Amazon Quick。

### 註冊 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**
   + **Client secret** (用戶端密碼)

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 整合或建立個人存取字符時，請根據您要使用的動作設定下列範圍。


**Airtable 建議範圍**  

| Scope (範圍) | Description | 
| --- | --- | 
| data.records:read | 讀取記錄中的資料。 | 
| data.records:write | 建立、編輯和刪除記錄。 | 
| data.recordComments:read | 讀取記錄中的註解。 | 
| data.recordComments:write | 建立、編輯和刪除記錄註解。 | 
| schema.bases:read | 讀取基礎結構，包括資料表名稱和欄位類型。 | 
| schema.bases:write | 編輯基底的結構，包括資料表名稱和欄位類型。 | 
| user.email:read | 讀取已驗證使用者的電子郵件地址。 | 

## 在 Amazon Quick 中設定連接器
<a name="airtable-quicksuite-setup"></a>

### 從可用索引標籤連線
<a name="airtable-quick-connect"></a>

如果您想要使用預設 OAuth 應用程式身分驗證，您可以直接從**可用**索引標籤連線，而不需要其他組態。

1. 在 Amazon Quick 主控台中，選擇**連接器**。

1. 在**可用**索引標籤上，尋找 **Airtable** 並選擇**連線**。

1. 完成 Airtable 登入流程，並授予請求的許可。

若要改為使用自訂 OAuth 應用程式或 API 金鑰設定連接器，請使用**為您的團隊建立**索引標籤，如下所述。

### 從為您的團隊建立索引標籤建立
<a name="airtable-full-setup"></a>

完成任何必要的 Airtable 組態後，請在 Amazon Quick 中建立連接器。

1. 在 Amazon Quick 主控台中，選擇**連接器**。

1. 選擇**為您的團隊建立**索引標籤。

1. 尋找並選擇 **Airtable**。
**注意**  
如果 Airtable 連接器已存在，則會出現一個對話方塊，其中包含您現有的連接器。若要使用現有的連接器，請選擇它。若要建立新的，請選擇**否，建立新的**。

1. 輸入連接器**的名稱**。或者，選擇 **\+ 新增描述**以新增描述。

1. 針對**連線類型**，選擇**公有網路**。

1. 針對 **OAuth 組態**，選擇下列其中一種身分驗證方法，並設定必要欄位。

   1. 對於**預設 OAuth 應用程式**：

      不需要額外的登入資料。選擇 **Next** (下一步) 繼續。

   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 個人存取字符。
      + **電子郵件** （選用） – 與您的 Airtable 帳戶相關聯的電子郵件地址。

1. 選擇**下一步**。

1. 如果您選擇**預設 OAuth 應用程式**或**自訂 OAuth 應用程式**，就會開啟 Airtable 授權視窗。檢閱請求的許可、選擇要授予存取權的基礎和工作區，然後選擇**授予存取權**。

1. 在**檢閱**頁面上，檢閱連接器的可用動作。選擇**下一步**。

1. 在**發佈**頁面上，選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權，或搜尋特定的團隊或群組。

1. 選擇**發布**。

## 可用動作
<a name="airtable-integration-actions"></a>

設定連接器之後，可以使用下列動作。


**Airtable 可用動作**  

| Category | Action | Description | 
| --- | --- | --- | 
| 記錄 | 列出記錄 | 列出具有選用篩選和排序之資料表中的記錄。 | 
| 記錄 | 取得記錄 | 依 ID 擷取特定記錄。 | 
| 記錄 | 批次建立記錄 | 在資料表中建立一或多個新記錄。 | 
| 記錄 | 更新記錄 | 更新現有記錄上的欄位。 | 
| 記錄 | 批次更新記錄 | 使用 PATCH 在單一操作中更新多個記錄。 | 
| 記錄 | 批次放置記錄 | 使用 PUT 在單一操作中更新多個記錄。 | 
| 說明 | 列出評論 | 列出對記錄的註解。 | 
| 說明 | 建立註解 | 將註解新增至記錄。 | 
| 說明 | 更新註解 | 編輯記錄的現有註解。 | 
| 結構描述 | 列出基礎 | 列出已驗證使用者可存取的所有基礎。 | 
| 結構描述 | 取得基本結構描述 | 擷取基礎的結構描述，包括資料表和欄位定義。 | 
| 結構描述 | 建立資料表 | 在基礎中建立新的資料表。 | 
| 結構描述 | 更新資料表 | 更新資料表屬性，例如名稱或描述。 | 
| 結構描述 | 建立欄位 | 將新欄位新增至資料表。 | 
| 結構描述 | 更新欄位 | 更新欄位屬性，例如名稱或類型。 | 
| 附件 | 建立附件 | 將附件上傳至記錄。 | 
| 使用者 | 取得使用者資訊 | 擷取已驗證使用者的相關資訊。 | 

**注意**  
您可以使用的動作取決於已驗證使用者可存取的基礎和工作區。

## 管理和疑難排解
<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)。