ZoomおよびZoom Phoneをマイアプリに登録するためには「Client ID」と「Client secret」が必要です。

ここではOAuth方式で上記の「Client ID」と「Client secret」を取得する方法を説明します。

それぞれをマイアプリへ登録するには、Zoomのアカウント登録（無料）が必要です。

アカウント未登録の場合は、マイアプリ登録前にこちらよりZoomのアカウントをご登録ください。

※こちらの連携方法は、ZoomのAdmin-managedの権限範囲での連携となります。

User-managedの権限範囲で連携したい場合はこちらをご参照ください。

Zoom App Marketplaceでのアプリ登録

こちらのページにアクセスし、ログイン（サインイン）します。
右上のDevelopというメニューから「Build App」をクリックします。

3.General Appを選択し、Createを押します。

4.設定画面に遷移するので、左上のアプリ名の鉛筆マークを押し、任意のアプリ名に設定します。

5.同じ画面上にあるSelect how the app is managedという項目内を以下のように変更します。

Admin-managedにチェックをつけ、Saveを押します。

6.同じ画面内下部にあるOAuth Informationという項目内を以下のように設定します。

OAuth Redirect URLという欄にまず以下のURLをペーストします。
```
HTTPS://yoom.fun/settings/my_apps/oauth_callback
```
その後、以下のURLをOAuth Redirect URLの先ほど入力したURLの上から再度ペーストします。また、OAuth Allow Listsの欄にも同様にペーストします。
```
https://yoom.fun/settings/my_apps/oauth_callback
```
※Use Strict Mode for Redirect URLsとSubdomain Checkについてはチェックは不要です。

↓

7.次に左メニューのScopesを押して、Add Scopesメニューにアクセスし、添付赤枠の
＋Add Scopesを押します。

8.検索窓に以下記載のScope内容をコピー＆ペーストで入れ、表示された対象Scopeにチェックを入れていき、すべてのチェックが完了したらDoneを押します。

このとき○○:adminか○○:masterのいずれかが表示される場合は、admin側のチェックをつけてください。

※Zoom（OAuth）とZoom Phoneでそれぞれ選択するScopeが異なります。

以下はZoom（OAuth）と連携時に選択するScopeです。

--------------------------------------------------

Report
- report:read:user:admin
Meeting
- meeting:write:meeting:admin
- meeting:read:list_meetings:admin
Webinar
- webinar:write:registrant:admin
- webinar:read:list_registrants:admin
- webinar:read:list_webinars:admin
Recording
- cloud_recording:read:list_recording_files:admin
- cloud_recording:delete:recording_file:admin
- cloud_recording:delete:meeting_recording:admin
User
- user:update:settings:admin
- user:delete:user:admin
- user:write:user:admin
- user:read:user:admin

--------------------------------------------------

以下はZoom Phoneと連携時に選択するScopeです。

--------------------------------------------------

Phone（Zoom Phoneと連携する場合に必要なScopeです）
- phone:read:list_call_logs:admin
- phone:read:call_log:admin
- phone:read:audio:admin
- phone:read:list_call_recordings:admin
- phone:read:call_recording:admin
- phone:read:user:admin

--------------------------------------------------

9.すべての設定が完了したら、画面左にあるApp CredentialsからClientIDとClient Secretをそれぞれコピーします。

Yoomで「Client ID」と「Client secret」を登録

上記で取得した「Client ID」と「Client secret」をYoomで登録します。

Yoomの「マイアプリ」ページからZoom（OAuth）を選択し、取得した「Client ID」と「Client secret」を設定し、登録するボタンをクリックしてください。

Zoomの認証画面が表示されるため、「Allow」ボタンをクリックしてください。

Zoom Phoneの連携で認証エラーが発生する場合

この場合、以下を参考にZoom、Zoom Phoneのプランや設定をご確認ください。

アカウントタイプの確認

ZoomアカウントにZoom Phone機能が有効化されていることを確認してください。この機能は通常、ビジネスまたはエンタープライズアカウントで利用可能です。無料または基本アカウントを使用している場合は、Zoom Phone機能を利用するためにアップグレードが必要です。

ライセンスの割り当て確認

Zoom Phone APIにアクセスしようとしているユーザーアカウントにZoom Phoneライセンスが割り当てられていることを確認してください。Zoom管理ポータルにログインし、「ユーザー管理」セクションに移動して、各ユーザーに割り当てられているライセンスを確認します。ライセンスが割り当てられていない場合は、ユーザーに割り当てる必要があります。

ユーザーに対するZoom Phoneの有効化

ユーザーにZoom Phoneが有効化されていない場合は、管理ポータルを通じて有効化できます。「電話システム管理」に移動し、「ユーザー」を選択します。そこから、ユーザーを見つけて、そのアカウントに対してZoom Phoneを有効化します。

以上で、Zoom（OAuth）およびZoom Phoneのマイアプリ登録が完了です 🎉