XTechグループ Advent Calendar 2020の7日目は、エキサイト株式会社エンジニアの@aharenchiがお送りします。

はじめに

オンライン会議やオンライン授業、オンライン飲み会など、人とのコミュニケーションはオンライン上が多くなってきました。
そんなオンラインコミュニケーションを楽しくするアプリを開発できるのだったらやってみたいと思うでしょう。
オンライン会議サービスのZoomでは無料でAPIを提供しており、APIを利用してMeetingの作成、ユーザ情報の作成、取得等様々なことを行うことが可能です。

「Zoom APIを使って面白いアプリを開発したい〜」と思い、次にZoom APIリファレンスページを閲覧すると、ドキュメントと「Send a Test Request」と書かれたツールを見つけるでしょう。

「Send a Test Request」では、Zoom APIにリクエストを実際に送信できミーティングの作成等ができます。
つまり、Zoom APIのリファレンスページ内でドキュメントを読む事とAPIの機能の応答を確認する事の両方ができるのです。便利ですね。

そこで今回は、Zoom APIをすぐに試せるようになることを目的に、ZoomのAPI認可の種類と、リファレンスページ内の「Send a Test Request」の使い方について説明します。

Zoom APIの利用準備

Zoomアカウント登録とアプリを作成する必要があります。

Zoomの公式サイトでZoomアカウントを新規作成してください。
すでにアカウントがある方はZoomアカウントでログインし、Zoom Developer Platformにアクセスしてください。

Create an Appというボタンがあるのでクリックしてアプリを作成します。
Create Appページでは、アプリの種類を選択することができます。
Zoom APIを利用する場合は、JWTとOAuthどちらかを選択します。

Zoom APIの認可について

JWTとOAuthとはZoom APIの認可の種類です。
認可とは、Zoom APIがAPI利用者に該当ユーザのZoom情報を操作する権限(例：ユーザの代わりにmeeting作成する権限/ユーザ情報を取得する権限)があるかを確認することです。

では、JWTとOAuthについてざっくり説明します。

JWT

アプリ作成時に発行されるAPI KeyとAPI Secretという鍵を使って認可を受けます。
操作できるZoomの情報は、そのアプリを作成したアカウントに所属するユーザの情報のみです。
Zoomでは1つのアカウントに複数のユーザを作成することができるのですが、そのアカウントに属するユーザの情報は操作することができます。
アプリを作成したアカウント以外のユーザに関してはZoom APIから操作できません。
個人用や1つの会社アカウントに属するユーザアカウントが利用するアプリをつくる場合は、JWTを選択するといいでしょう。

OAuth

ユーザにブラウザログインしてもらい、Zoomの情報を操作することを認可してもらうことで実現します。
操作できるZoomの情報は、ブウザログインして認可をしたユーザの情報です。
不特定多数のZoomアカウントが利用するアプリをつくる場合は、OAuthを選択するといいでしょう。

ざっくりJWTとOAuthについて分かったと思いますので、次はそれぞれのアプリの作成手順とTest Requestを実行する方法を説明します。

JWTでのアプリ作成とTest Requestを実行する方法

JWT認可アプリを作成し、Zoom APIを利用してミーティング作成までを行います。

1. アプリ作成ページで、JWTを選択

アプリ作成ページで、JWTを選択します。

2. 必要な情報を記入

以下の情報が入力必須なので記入していきます。
- アプリ名
- 会社名
- 開発者名
- 開発者のメールアドレス

3. App Credentialsページのデータを参照

通常は、API KeyとAPI Secretを使ってJWT Tokenを生成し認可を行いますが、すでに生成されたJWT Tokenも表示されています。
今回はすぐに試すことが目的なので、生成済みのJWT Tokenを使います。( ※ このJWT Tokenは本番アプリでは使用しないでください。)
API KeyとAPI Secretを使ったJWT Tokenを生成方法はZoomドキュメントを参照ください。

4. Feature設定

Webhook通知を設定することができます。今回は設定しません。

5. Activation設定

アプリがアクティブになってることを確認できたら、App作成終了です。

6. Zoomミーティング作成

今回は、エンドポイント「/users/{userId}/meetings」を使って、インスタントミーティングを作成します。
「/users/{userId}/meetings」のページにアクセスし、oauth_access_tokenにJWT Token、userIdにZoomアカウントのメールアドレスを記入します。Bodyにはミーティングの種類をインスタントとして記入します。

Sendボタンをクリックするとレスポンスが返ってきます。レスポンスの中身にZoomURLが含まれており、そのURLにアクセスするとZoomミーティングを開始することができます！Zoomミーティング作成完了です！ぱちぱち👏

OAuthでのアプリ作成とTest Requestを実行する方法

OAuth認可アプリを作成し、Zoom APIを利用してミーティング作成までを行います。

1. アプリ作成ページで、OAuthを選択

アプリ作成ページで、OAuthを選択します。

2. OAuthアプリの設定

「Choose app type」ではZoom情報のアクセス範囲を設定できます。エンドポイントごとに、「Account-level app」か「User-managed app」か決まっているのでそれを確認して設定しましょう。「/users/{userId}/meetings」は「Account-level app」である必要があるので、それを設定します。

作成したアプリはマーケットプレイスに公開することができます。今回はお試し実行なので、公開設定はOFFにします。