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

# Zoom 統合
<a name="zoom-integration"></a>

Zoom アクションコネクタを使用すると、自然言語を通じて Amazon Quick で Zoom プラットフォームに直接アクセスできます。Amazon Quick を離れることなく、会議の作成と管理、録音と会議の概要へのアクセス、ウェビナーの詳細の表示、連絡先の検索を行うことができます。

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

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

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

統合を設定する前に、以下があることを確認してください。
+ 使用する会議、録音、ウェビナーにアクセスできるアクティブな Zoom アカウント。
+ **カスタム OAuth アプリ**の場合: [Zoom ウェブサイトの Zoom App Marketplace](https://marketplace.zoom.us/) にアクセスしてアプリを作成します。
+ Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## ズームの設定
<a name="zoom-source-setup"></a>

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

カスタム OAuth アプリ認証の場合は、Amazon Quick を設定する前に、Zoom App Marketplace で次の手順を実行します。

### Zoom アプリを作成する (カスタム OAuth アプリ)
<a name="zoom-register-oauth"></a>

Zoom App Marketplace でアプリを作成し、Amazon Quick に必要なクライアント認証情報を取得します。詳細については、Zoom Developer ウェブサイトの[OAuth](https://developers.zoom.us/docs/integrations/oauth/)」を参照してください。

1. [Zoom ウェブサイトの Zoom App Marketplace](https://marketplace.zoom.us/) にサインインし、アプリ作成ポータルに移動します。

1. 新しい アプリケーションを作成します。ユーザーベースの OAuth の場合は **General**、service-to-service認証の場合は **Server-to-Server OAuth** を選択します。

1. **基本情報**タブの**アプリ認証情報**で、次の値を記録します。Amazon Quick を設定するときに必要になります。
   + **クライアント ID**
   + **クライアントシークレット**

1. **OAuth Information** セクションの **Authorized Redirect URI **に、Amazon Quick コールバック URL を追加します。 `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. **スコープ** タブを選択し、 **\+ スコープを追加** を選択して、統合に必要なアクセス許可を選択します。推奨されるスコープについては、「」を参照してください[推奨されるスコープ](#zoom-oauth-scopes)。

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

Zoom に接続すると、次のスコープがリクエストされます。カスタム Zoom アプリを作成するときは、スコープタブにこれらの**スコープ**を追加します。


**推奨されるスコープをズームする**  

| スコープ | 説明 | 
| --- | --- | 
| meeting:read:list\_meetings | 会議を一覧表示します。 | 
| meeting:read:meeting | 会議の詳細を読み取ります。 | 
| meeting:read:summary | 会議の概要を読み取ります。 | 
| meeting:read:list\_past\_participants | 過去の会議参加者を一覧表示します。 | 
| meeting:read:list\_past\_instances | 過去の会議インスタンスを一覧表示します。 | 
| meeting:write:meeting | 会議を作成します。 | 
| meeting:update:meeting | 会議を更新します。 | 
| meeting:delete:meeting | 会議を削除します。 | 
| meeting:write:registrant | 会議登録者を追加します。 | 
| cloud\_recording:read:list\_user\_recordings | ユーザー録音を一覧表示します。 | 
| cloud\_recording:read:list\_recording\_files | 録音ファイルを一覧表示します。 | 
| cloud\_recording:delete:meeting\_recording | 会議の録音を削除します。 | 
| webinar:read:webinar | ウェビナーの詳細を読み取ります。 | 
| webinar:read:list\_webinars | ウェビナーを一覧表示します。 | 
| webinar:read:list\_past\_participants | 過去のウェビナー参加者を一覧表示します。 | 
| webinar:read:list\_registrants | ウェビナー登録者を一覧表示します。 | 
| webinar:write:registrant | ウェビナー登録者を追加します。 | 
| user:read:user | ユーザー情報を読み取ります。 | 
| user:read:settings | ユーザー設定を読み取ります。 | 
| user:read:list\_collaboration\_devices | コラボレーションデバイスを一覧表示します。 | 
| contact:read:list\_contacts | 連絡先を一覧表示します。 | 

**注記**  
ホワイトボードおよびマーケットプレイス機能の追加スコープもリクエストされます。上記のスコープは、主要な会議、録画、ウェビナー、ユーザー、および問い合わせアクションを対象としています。

## Amazon Quick でのコネクタのセットアップ
<a name="zoom-quicksuite-setup"></a>

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

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

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

1. **使用可能**タブで、**ズーム**を見つけて**接続**を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

   1. **カスタム OAuth アプリ**の場合は、次のフィールドを設定します。
      + **ベース URL** (オプション) – Zoom API ベース URL。例: `https://api.zoom.us`
      + **クライアント ID** – Zoom アプリのクライアント ID。
      + **クライアントシーク**レット – Zoom アプリからのクライアントシークレット。
      + **トークン URL** – トークンエンドポイント。例: `https://zoom.us/oauth/token`
      + **認可 URL** – 認可エンドポイント。例: `https://zoom.us/oauth/authorize`
      + **リダイレクト URL** – Amazon Quick コールバック URL があらかじめ入力されています。

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

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

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

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

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

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

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


**使用可能なアクションをズームする**  

| Category | [アクション] | 説明 | 
| --- | --- | --- | 
| 会議 | 会議を一覧表示する | ユーザーの会議を一覧表示します。 | 
| 会議 | 会議を取得する | 特定の会議の詳細を取得します。 | 
| 会議 | 会議の作成 | 新しい会議を作成します。 | 
| 会議 | 会議の更新 | 既存の会議を更新します。 | 
| 会議 | 会議の概要を取得する | 会議の AI 生成の概要を取得します。 | 
| 会議 | 会議概要テンプレートを一覧表示する | 利用可能な会議概要テンプレートを一覧表示します。 | 
| 会議 | 過去の会議参加者を取得する | 過去の会議から参加者を取得します。 | 
| 会議 | 過去の会議インスタンスを一覧表示する | 定期的な会議のインスタンスを一覧表示します。 | 
| 会議 | 会議登録者を作成する | 会議に登録者を追加します。 | 
| 記録 | 録画を一覧表示する | ユーザーのすべての録画を一覧表示します。 | 
| 記録 | 会議記録の取得 | 特定の会議の記録を取得します。 | 
| 記録 | アーカイブされたファイルを一覧表示する | アーカイブされた録音ファイルを一覧表示します。 | 
| ウェビナー | ウェビナーを一覧表示する | ユーザーのウェビナーを一覧表示します。 | 
| ウェビナー | ウェビナーを取得する | 特定のウェビナーの詳細を取得します。 | 
| ウェビナー | ウェビナー参加者を一覧表示する | ウェビナーの参加者を一覧表示します。 | 
| Contacts | 会社の連絡先を検索する | 会社ディレクトリ内の連絡先を検索します。 | 
| デバイス | デバイスのリスト | Zoom デバイスを一覧表示します。 | 
| レポート | 日次使用状況レポートの取得 | 毎日の使用状況レポートを取得します。 | 
| [ユーザー] | ユーザーの取得 | 認証されたユーザーに関する情報を取得します。 | 

**注記**  
使用できるアクションは、Zoom アカウントに設定されたアクセス許可と、認証されたユーザーがアクセスできるデータによって異なります。

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

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

### 認証問題
<a name="zoom-troubleshooting-auth"></a>
+ **サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ)** – Zoom アカウントがアクティブであり、Zoom ウェブサイトで [zoom.us](https://zoom.us) に直接サインインできることを確認します。カスタム OAuth アプリの場合、Zoom アプリのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。
+ **無効なクライアント認証情報 (カスタム OAuth アプリ)** – クライアント ID とクライアントシークレットが Zoom アプリの値と一致していることを確認します。Zoom App Marketplace のアプリ設定から認証情報を表示できます。
+ **アクセス許可が不十分** – Zoom アプリ用に設定されたスコープに、使用するアクションに必要なアクセス許可が含まれていることを確認します。「[推奨されるスコープ](#zoom-oauth-scopes)」を参照してください。