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

# Dropbox 整合
<a name="dropbox-integration"></a>

使用 Dropbox 動作連接器，您可以透過自然語言直接在 Amazon Quick 中存取 Dropbox 平台。您可以上傳檔案、管理資料夾結構、產生共用連結，以及搜尋內容，而無需離開 Amazon Quick。

Amazon Quick 支援 Dropbox 的多種身分驗證方法。選擇最適合您組織安全需求的方法。
+ **預設 OAuth 應用程式** – 使用 AWS受管 OAuth 應用程式。不需要額外的登入資料。您使用 Dropbox 帳戶直接進行身分驗證。
+ **自訂 OAuth 應用程式** – 使用在 Dropbox 中註冊的客戶受管 OAuth 應用程式。此選項可讓您的組織完全控制 OAuth 組態。
+ **API 金鑰** – 使用 Dropbox 存取字符進行身分驗證。此方法適用於個別使用或測試。

如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 [身分驗證方法](quick-action-auth.md)。

## 開始之前
<a name="dropbox-integration-prerequisites"></a>

在設定整合之前，請確定您有下列項目。
+ 作用中的 Dropbox 帳戶，可存取您要使用的檔案和資料夾。
+ 對於**自訂 OAuth 應用程式**：存取 [Dropbox 網站上的 Dropbox 應用程式主控台](https://www.dropbox.com/developers/apps)以建立應用程式。
+ 針對 **API 金鑰**：從 [Dropbox 網站上的 Dropbox 應用程式主控台](https://www.dropbox.com/developers/apps)產生的存取字符。
+ 如需 Amazon Quick 訂閱需求，請參閱 [在主控台中設定整合](integration-console-setup-process.md)。

## 設定 Dropbox
<a name="dropbox-source-setup"></a>

如果您使用的是**預設 OAuth 應用程式**身分驗證，請略過本節並前往 [在 Amazon Quick 中設定連接器](#dropbox-quicksuite-setup)。

對於自訂 OAuth 應用程式或 API 金鑰身分驗證，請先完成 Dropbox 中的適用步驟，再設定 Amazon Quick。

### 為自訂 OAuth 應用程式建立 Dropbox 應用程式
<a name="dropbox-register-oauth"></a>

在 Dropbox 應用程式主控台中建立應用程式，以取得 Amazon Quick 所需的用戶端登入資料。

1. 登入您的 Dropbox 帳戶，然後前往 [Dropbox 網站上的 Dropbox 應用程式主控台](https://www.dropbox.com/developers/apps)。

1. 選擇**建立應用程式**。

1. 針對**選擇 API**，選取**範圍存取**。

1. 選擇您需要的存取類型：
   + **應用程式資料夾** – 僅提供特定資料夾的存取權。
   + **完整 Dropbox** – 提供存取所有檔案和資料夾的權限。

1. 輸入應用程式名稱，然後選擇**建立應用程式**。

1. 在應用程式設定頁面上，記錄下列值。您在設定 Amazon Quick 時需要它們。
   + **應用程式金鑰** – 這是您的用戶端 ID。
   + **應用程式秘密** – 這是您的用戶端秘密。

1. 在 **OAuth 2** 下，於**重新導向 URIs**區段中，新增 Amazon Quick 回呼 URL： `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. 選擇**許可**索引標籤，然後選取整合所需的範圍。如需建議的範圍，請參閱 [建議範圍](#dropbox-oauth-scopes)。

### 產生 API 金鑰的存取字符
<a name="dropbox-create-token"></a>

從 Dropbox 應用程式主控台產生存取字符，以進行 API 金鑰身分驗證。

1. 登入您的 Dropbox 帳戶，然後前往 [Dropbox 網站上的 Dropbox 應用程式主控台](https://www.dropbox.com/developers/apps)。

1. 選擇您的應用程式，或視需要建立新的應用程式。

1. 在 **OAuth 2 **下，選擇**產生**以建立存取權杖。

1. 複製並安全地存放產生的字符。您在設定 Amazon Quick 時需要它。

### 建議範圍
<a name="dropbox-oauth-scopes"></a>

當您建立 Dropbox 應用程式時，請根據您要使用的動作，在**許可**索引標籤上設定下列範圍。


**Dropbox 建議範圍**  

| Scope (範圍) | Description | 
| --- | --- | 
| account\_info.read | 讀取帳戶資訊。 | 
| account\_info.write | 更新帳戶資訊。 | 
| contacts.read | 讀取聯絡資訊。 | 
| contacts.write | 更新聯絡資訊。 | 
| events.read | 讀取事件日誌項目。 | 
| events.write | 建立事件日誌項目。 | 
| file\_requests.read | 讀取檔案請求。 | 
| file\_requests.write | 建立和管理檔案請求。 | 
| files.content.read | 讀取檔案內容。 | 
| files.content.write | 建立、修改和刪除檔案。 | 
| files.metadata.read | 讀取檔案和資料夾中繼資料。 | 
| files.metadata.write | 編輯檔案和資料夾中繼資料。 | 
| files.permanent\_delete | 永久刪除檔案。 | 
| files.team\_metadata.read | 讀取團隊檔案中繼資料。 | 
| files.team\_metadata.write | 編輯團隊檔案中繼資料。 | 
| groups.read | 讀取群組資訊。 | 
| groups.write | 管理 群組。 | 
| members.delete | 移除團隊成員。 | 
| members.read | 讀取團隊成員資訊。 | 
| members.write | 管理團隊成員。 | 
| sessions.list | 列出作用中工作階段。 | 
| sessions.modify | 修改作用中工作階段。 | 
| sharing.read | 讀取共用設定和共用連結。 | 
| sharing.write | 建立和管理共用連結和資料夾共用。 | 
| team\_data.content.read | 讀取團隊內容。 | 
| team\_data.content.write | 管理團隊內容。 | 
| team\_data.governance.read | 讀取團隊資料控管設定。 | 
| team\_data.governance.write | 管理團隊資料控管設定。 | 
| team\_data.team\_space | 存取團隊空間資料。 | 
| team\_info.read | 讀取團隊資訊。 | 
| team\_info.write | 更新團隊資訊。 | 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   1. 對於**自訂 OAuth 應用程式**，請設定下列欄位：
      + **基本 URL** （選用） – Dropbox API 基本 URL。範例：`https://api.dropboxapi.com`
      + **用戶端 ID** – 來自 Dropbox 應用程式的應用程式金鑰。
      + **用戶端秘密** – 來自 Dropbox 應用程式的應用程式秘密。
      + **權杖 URL** – 權杖端點。範例：`https://api.dropboxapi.com/oauth2/token`
      + **授權 URL** – 授權端點。範例：`https://www.dropbox.com/oauth2/authorize`
      + **重新導向 URL** – 預先填入 Amazon Quick 回呼 URL。

   1. 針對 **API 金鑰**，設定下列欄位：
      + **基本 URL** （選用） – Dropbox API 基本 URL。範例：`https://api.dropboxapi.com`
      + **API 金鑰** – 您的 Dropbox 存取字符。
      + **電子郵件** （選用） – 與您的 Dropbox 帳戶相關聯的電子郵件地址。

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

1. 如果您選擇**預設 OAuth 應用程式**或**自訂 OAuth 應用程式**，就會開啟 Dropbox 授權視窗。檢閱請求的許可，然後選擇**允許**。

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

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

1. 選擇**發布**。

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

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


**Dropbox 可用的動作**  

| Category | Action | Description | 
| --- | --- | --- | 
| 檔案 | 列出檔案 | 列出資料夾中的檔案。 | 
| 檔案 | 取得檔案 | 讀取檔案的內容。 | 
| 檔案 | 匯入檔案 | 將檔案上傳至 Dropbox。 | 
| 檔案 | 搜尋檔案 | 依名稱或內容搜尋檔案或資料夾。 | 
| 檔案 | 更新檔案位置 | 將檔案或資料夾移至不同的位置。 | 
| 檔案 | 取得暫時連結 | 產生檔案的暫時下載連結。 | 
| 檔案 | 取得中繼資料 | 擷取檔案或資料夾的中繼資料。 | 
| 檔案 | 從 URL 儲存檔案 | 從 URL 將檔案儲存至 Dropbox。 | 
| 資料夾 | 建立資料夾 | 建立新的資料夾。 | 
| 資料夾 | 列出資料夾 | 使用者可以存取的資料夾清單。 | 
| 批次操作 | 取得批次移動狀態 | 檢查批次移動操作的狀態。 | 
| 共用 | 建立共用連結 | 建立檔案或資料夾的共用連結。 | 
| 共用 | 列出共用連結 | 列出檔案或資料夾的共用連結。 | 
| 共用 | 更新資料夾共用 | 與其他使用者共用資料夾。 | 
| 共用 | 列出收到的檔案 | 列出其他使用者已與您共用的檔案。 | 
| 檔案請求 | 建立檔案請求 | 建立檔案請求供其他人上傳檔案。 | 
| 帳戶 | 取得使用者 | 擷取已驗證使用者的相關資訊。 | 
| 帳戶 | 取得空間用量 | 擷取帳戶的儲存空間用量。 | 

**注意**  
您可以使用的動作取決於已驗證使用者可存取的檔案和資料夾。

## 管理和疑難排解
<a name="dropbox-integration-troubleshooting"></a>

若要編輯、共用或刪除連接器，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。

### 驗證問題
<a name="dropbox-troubleshooting-auth"></a>
+ **登入失敗 （預設 OAuth 應用程式或自訂 OAuth 應用程式）** – 確認您的 Dropbox 帳戶處於作用中狀態，而且您可以直接登入 [Dropbox 網站](https://www.dropbox.com)。對於自訂 OAuth 應用程式，請確認 Dropbox 應用程式中的重新導向 URL 符合 Amazon Quick 回呼 URL。
+ **無效用戶端登入資料 （自訂 OAuth 應用程式）** – 驗證用戶端 ID 和用戶端秘密是否符合 Dropbox 應用程式中的應用程式金鑰和應用程式秘密值。如果您重新產生應用程式秘密，請更新 Amazon Quick 中的值。
+ **API 金鑰遭拒** – 驗證您的存取字符是否處於作用中狀態。在 Dropbox 應用程式主控台中，權杖可能會過期或遭到撤銷。
+ **許可不足** – 確認您的 Dropbox 應用程式具有您要使用的動作所需的許可範圍。