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のマイアプリ登録が完了です 🎉