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

# 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 キー認証の場合は、Amazon Quick を設定する前に Dropbox で該当するステップを完了してください。

### カスタム 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. 必要なアクセスのタイプを選択します。
   + **アプリケーションフォルダ** – 特定のフォルダにのみアクセスを提供します。
   + **Full 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>

API キー認証のために Dropbox アプリコンソールからアクセストークンを生成します。

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 が推奨するスコープ**  

| スコープ | 説明 | 
| --- | --- | 
| 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. Connection **type** で、**Public network** を選択します。

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

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

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

   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 アクセストークン。
      + E **メール** (オプション) – Dropbox アカウントに関連付けられている E メールアドレス。

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

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

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

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

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

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

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


**Dropbox で使用可能なアクション**  

| Category | [アクション] | 説明 | 
| --- | --- | --- | 
| ファイル | ファイルのリスト | フォルダ内のファイルを一覧表示します。 | 
| ファイル | ファイルの取得 | ファイルの内容を読み込みます。 | 
| ファイル | ファイルのインポート | 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 アプリに、使用するアクションに必要なアクセス許可スコープがあることを確認します。