リモート会議API「Zoom REST API」の実践入門（Server -To-Server OAuth）

リモート会議を開催するとき、アプリケーションのZoomを使われてる人も多いと思います。
Zoomには、Pythonによってプログラミング可能なWeb-APIであるREST APIが用意されています。
このAPIを使えば、リモート会議を組み込んだアプリケーションを開発することができます。

Zoom REST APIは、REST APIのため、HTTPプロトコルのリクエスト・レスポンスを使っています。
専用のAPIライブラリなどは、提供されていません。したがって、プログラミング環境で、HTTPリクエスト・レスポンスを送受信できれば、使うことができます。

Zoom REST APIには、会議だけでなく、ウェビナー（セミナー）、チャットなどZoomで使える機能が一通り、揃っています。

※２０２３年９月１日より、JWTアプリケーションは未サポートとなるようです。
　JWTアプリケーションを使用している方には、以下のようにServer-To-Server OAuthなどの使用を
　促されるメールがきているはずです。

■　Zoom REST APIを使うための準備

Zoom REST APIを使うためには、まず、以下を実施する必要があります。

１）Zoomにアカウント登録する
　
Zoomの無料のアカウントを作成します。誕生日（意味不明）、メールアドレスを入力して作成ます。

２）開発者用のデベロッパーサイトにログインする

Zoomのデベロッパーサイトから、１）で作成したアカウントでサインインします。

３）Server-To-Server OAuthアプリケーションを作成する

Zoomサーバへのリクエストを認証するために、トークンを使います。
そのため、Server-To-Server OAuthアプリケーションを作成しておく必要があります。

右上のプルダウンから「Build App」を選択し、アプリケーションタイプのServer-To-Server OAuthの「Create」をクリックし、アプリケーション名を入力し、作成します。

画像に alt 属性が指定されていません。ファイル名: image-2-1024x546.png

画像に alt 属性が指定されていません。ファイル名: image-3-1024x546.png

画像に alt 属性が指定されていません。ファイル名: image-4-1024x546.png

作成後、以下のようにREST APIで使うAPIキー（Client ID）とAPI秘密鍵（Client Secret）が生成されます。これらをメモしておきます。

画像に alt 属性が指定されていません。ファイル名: image-5-1024x546.png

■　会議機能を使う

主な会議機能は次の通りです。

・リモート会議を生成する
・リモート会議招待テキストを取得する
・リモート会議情報を取得する
・リモート会議全リストを取得する
　（リモート会議の存在をチェックする）
・リモート会議を削除する

Pythonによるコード例を以下に示します。

# -*- coding: utf-8 -*-
import requests
import json
import datetime
from dateutil import tz
import dateutil.parser
import jwt
import time
import random
from pprint import pprint
from tzlocal import get_localzone
from requests.auth import HTTPBasicAuth

#
# Meetingクラス
#
class MeetingClass:
    _token = None
    _meeting_id = None
    _meeting_status = None
    _meeting_uuid = None
    _meeting_json = None

    CONST_ZOOM_URL = 'https://api.zoom.us/v2'                           #  Zoom APIのURL
    CONST_ZOOM_API_KEY = 'XXXXXXXXXXXXXXXXXXXXXX'                       #  API key(Server-to-Server OAuth : client_id) 
    CONST_ZOOM_API_SECRET = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'          #  API secret(Server-to-Server OAuth : client_secret)
    CONST_ZOOM_USER_ID = 'user@test.org'                                # 主催者のメールアドレス
    CONST_ZOOM_TOKEN_EXPIRE_SEC = 600                                   # トークン有効期限：600秒



    # トークン取得メソッド
    def _GetToken(self):

        # endpoint to get invitationn text
        end_point = f"https://zoom.us/oauth/token"

        #  ベーシック認証設定（client id と Client Secretを設定）
        auth=HTTPBasicAuth(self.CONST_ZOOM_API_KEY, self.CONST_ZOOM_API_SECRET)

        #　ヘッダ生成
        headers = {'Host': 'zoom.us',
                   'Content-Type' : 'application/x-www-form-urlencoded'}

        data = 'grant_type=account_credentials'
        data += '&'
        data += 'account_id=8elTaiRVThOVdCsoL6AMPA'

        try:
            
            # リクエスト送信（生成：POST）
            response = requests.request('POST',
                                    end_point,
                                    headers=headers,
                                    data=data,
                                    auth=auth)

            # 次の形式のレスポンスのテキストをJSON形式に変換
            #{
            #      “Access_token“: String,
            #      “Token_type”: “bearer”,
            #      “Expire_in”: long,
            #      “scope” : [String]
            #}
            token_data = json.loads(response.text)
            self._token = token_data['access_token']
            return self._token

        except Exception as e:
            print(e)
            return None


    #  デフォルト設定JSON生成メソッド
    def _CreateDefaultSettings(self,contact_name:str,contact_email:str):

        return {
            'host_video': True,             # start video when the host joins
            'participant_video': True,      # start video when the participants join
            'join_before_host': True,       # no host
            'jbh_time': 0,                  # Allow the participant to join the meeting at anytime.(デフォルトっぽい)
            'mute_upon_entry': True,        # mute paticipants upon entry
            'approval_type': 0,             # automatically approve
            'cn_meeting': False,            # host meeting in china
            'in_meeting': False,            # host meeting in india
            'watermark': False,             # add a watermark when viewing a shared screen
            'use_pmi': False,               # personal meeting id
            'registration_type': 1,         # The meeting's registration type
            'audio': "voip",                # How participants join the audio portion of the meeting
            'auto_recording': "none",       # The automatic recording settings
            'enforce_login': False,                     # enfoce login
            'waiting_room': False,                      # Whether to enable the Waiting Room feature if this values true,this disables the join_before_hosts setting
            'registrants_email_notification': False,    # Whether to sedn registants email notifications abount their registration approval cancellation or rejection
            'meeting_authentication': False,    # if true ,only authenticated users can join the meeting
            'contact_name': contact_name,       # The contact name for meeting registration
            'contact_email': contact_email}     # The contact email for meeting registration

    #  リクエストヘッダ生成メソッド
    def _GetHeaders(self,expire_sec: int):

        # トークン取得
        token=self._GetToken()
        if token is None:
            return None


        # トークンを設定し、ヘッダ(JSON)作成
        headers = {'Authorization': f"Bearer {self._token}",
                   'Content-Type': 'application/json'}

        return headers

    #   
    #  リモート会議生成メソッド
    #     topic
    #     start_time
    #     duration_min
    #     pass_code
    #     contact_name
    #     contact_email
    #
    def CreateMeeting(self, topic: str, start_time: datetime, duration_min: int,pass_code: str,contact_name:str,contact_email:str):

        # リモート会議作成用のURLを生成
        end_point =  f'/users/{self.CONST_ZOOM_USER_ID}/meetings'

        #　トークンのタイムアウト値を指定し、リクエストヘッダを生成
        headers = self._GetHeaders(self.CONST_ZOOM_TOKEN_EXPIRE_SEC)
        if headers is None:
            return None

        # パスコードが未指定なら自動生成する
        if not pass_code:
            pass_code = str(random.randint(100000, 999999))
        
        # 会議のデフォルトパラメータを設定
        default_setting = self._CreateDefaultSettings(contact_name,contact_email)

        # リクエストのボディ部を生成
        body = {
            "topic": topic, # 会議の題名（Invitationに含まれる）
            'type': 2,  # scheduled meeting
            "start_time": start_time.isoformat(),
            "duration": duration_min,
            "timezone": "Osaka, Sapporo, Tokyo",
            "password": pass_code,
            #"agenda": agenda,
            "settings": default_setting}

        try:
            # リクエスト送信（生成：POST）
            # This API has a daily rate limit of 100 requests per day. 
            # Therefore, only 100 Create a Meeting API requests are permitted within a 24 hour window for a user.
            response = requests.request('POST',
                                    self.CONST_ZOOM_URL + end_point,
                                    headers=headers,
                                    data=json.dumps(body)).json()

            # レスポンス(JSON)からデータ取得
            self._meeting_id = response['id']   # meeting id
            self._status = response['status']   # 会議の状態
            self._uuid = response['uuid']       # uuid
            self._meeting_json = response       # レスポンス全体

            return self._meeting_id

        except Exception as e:
            print(e)
            return None

    #
    #  リモート会議招待用テキスト取得メソッド
    #
    def GetInvitation(self, meeting_id: int):

        # リモート会議招待用テキスト取得のURLを生成
        end_point = f"/meetings/{meeting_id}/invitation"

        #　トークンのタイムアウト値を指定し、リクエストヘッダを生成
        headers = self._GetHeaders(self.CONST_ZOOM_TOKEN_EXPIRE_SEC)
        if headers is None:
            return None
        
        # リクエスト送信（取得：GET）
        invitation = requests.request("GET",
                                self.CONST_ZOOM_URL + end_point,
                                headers=headers).json()
        return invitation

    #
    #  リモート会議情報取得メソッド
    #
    def GetMeeting(self, meeting_id: int):

        # リモート会議情報取得のURLを生成
        end_point = f"/meetings/{meeting_id}"

        #　トークンのタイムアウト値を指定し、リクエストヘッダを生成
        headers = self._GetHeaders(self.CONST_ZOOM_TOKEN_EXPIRE_SEC)
        if headers is None:
            return None
        

        # リクエスト送信（取得：GET）
        return requests.request("GET",
                                self.CONST_ZOOM_URL + end_point,
                                headers=headers).json()
        

    #
    #  リモート会議更新メソッド
    #
    def UpdateMeeting(self, meeting_id: int,topic: str, start_time: datetime, duration_min: int,pass_code: str,contact_name:str,contact_email:str):

        # リモート会議更新用のURLを生成
        end_point = f"/meetings/{meeting_id}"

        #　トークンのタイムアウト値を指定し、リクエストヘッダを生成
        headers = self._GetHeaders(self.CONST_ZOOM_TOKEN_EXPIRE_SEC)
        if headers is None:
            return False

        # パスコードが未指定なら自動生成する
        if not pass_code:
            pass_code = str(random.randint(100000, 999999))
        
        # 会議のデフォルトパラメータを設定
        default_setting = self._CreateDefaultSettings(contact_name,contact_email)

        # リクエストのボディ部を生成
        body = {
            "topic": topic,
            'type': 2,  # scheduled meeting
            "start_time": start_time.isoformat(),
            "duration": duration_min,
            "timezone": "Osaka, Sapporo, Tokyo",
            "password": pass_code,
            "settings": default_setting}

        try:

            # リクエスト送信（更新：PATCH）
            response = requests.request('PATCH',
                                    self.CONST_ZOOM_URL + end_point,
                                    headers=headers,
                                    data=json.dumps(body))

            # 正常(status code : 204)
            if response.status_code == 204:
                return True

            return False
        
        except Exception as e:
            print(e)
            return False

    #
    #  リモート会議削除メソッド
    #
    def DeleteMeeting(self, meeting_id: int):

        # リモート会議削除用のURLを生成
        end_point = f"/meetings/{meeting_id}"

        #　トークンのタイムアウト値を指定し、リクエストヘッダを生成
        headers = self._GetHeaders(self.CONST_ZOOM_TOKEN_EXPIRE_SEC)
        if headers is None:
            return False
        
        try:

            # リクエスト送信（削除：DELETE）
            response = requests.request('DELETE',
                                    self.CONST_ZOOM_URL + end_point,
                                    headers=headers)

            # 正常(status code : 204)
            if response.status_code == 204:
                return True

            return False
        
        except Exception as e:
            print(e)
            return False

    #
    #  リモート会議リスト取得メソッド
    #
    def GetMeetingList(self,next_page_token,page_number):

        # リモート会議リスト取得用のURLを生成
        end_point =  f'/users/{self.CONST_ZOOM_USER_ID}/meetings'

        # 取得するタイプに”スケジュール”、１ページ当たりの取得件数を100件で指定
        params =  '?type=scheduled&page_size=100'
        #params =  '?type=scheduled&page_size=1'

        # 次ページの取得の場合、次ページ用トークンとページ番号を指定
        if len(next_page_token) > 0:
            params += '&next_page_token='+ next_page_token
        if len(page_number) > 0:
            params += '&page_number='+ page_number

        #　トークンのタイムアウト値を指定し、リクエストヘッダを生成
        headers = self._GetHeaders(self.CONST_ZOOM_TOKEN_EXPIRE_SEC)
        if headers is None:
            return None

        # リクエスト送信（取得：GET）
        return requests.request("GET",
                                self.CONST_ZOOM_URL + end_point + params,
                                headers=headers).json()

    #
    #  リモート会議リストを全件取得するメソッド
    #
    def GetMeetingListAll(self):

        meetings=[]
        next_page_token = ''
        page_number = 1

        #  リモート会議リスト取得       
        response =self.GetMeetingList('','')

        # レスポンスのページ番号を取得
        if 'page_number' in response and  response['page_number'] != None:
            page_number=int(response['page_number'])

        # 次ページ用トークンを取得
        next_page_token=response['next_page_token']

        # 取得した会議情報を保存
        meetings.extend(response['meetings']) 

        # 全ページ分繰り返し
        while(next_page_token != None and len(next_page_token) > 0 ):

            #  リモート会議リスト取得                  
            response =self.GetMeetingList(next_page_token,str(page_number))

            # レスポンスのページ番号を取得
            if 'page_number' in response and  response['page_number'] != None:
                page_number=int(response['page_number'])
            #else:
            #    page_number += 1

            # 次ページ用トークンを取得
            next_page_token=response['next_page_token']

            # 取得した会議情報を保存
            meetings.extend(response['meetings']) 

        return meetings

    #
    #  リモート会議リストから該当時間の会議があるかチェックするメソッド
    #
    def IsExistMeeting(self,meeting_list,start_time,duration):

        #　終わりの時間にする
        end_time =  start_time + datetime.timedelta(minutes=duration)

        for scheduled_meeting in meeting_list:

            # リモート会議情報のタイムゾーンを取得
            scheduled_timezone = tz.gettz(scheduled_meeting['timezone'])

            # リモート会議情報の開始時間をタイムゾーン付きの時間に変換する
            scheduled_start_time = dateutil.parser.parse(scheduled_meeting['start_time']).astimezone(scheduled_timezone)

            # 終わりの時間を取得
            scheduled_end_time =  scheduled_start_time + datetime.timedelta(minutes=scheduled_meeting['duration'])

            # 該当時間の会議があるかチェック
            if start_time >= scheduled_start_time or end_time <= scheduled_end_time :
                return True

        return False


if __name__ == '__main__':
    
    client = MeetingClass()


    # 
    #  リモート会議を生成する
    #

    # 　開始・終了時間　-->  開始時間、会議時間（分）に変換
    day = '2022/6/6'
    start_time = '16:30'
    end_time = '17:30'
    mtg_start_time = datetime.datetime.strptime(day + ' ' + start_time, '%Y/%m/%d %H:%M')
    mtg_end_time = datetime.datetime.strptime(day + ' ' + end_time, '%Y/%m/%d %H:%M')
    duration_min = int((mtg_end_time - mtg_start_time).seconds / 60)

    # 開始時間にTimeZone付与
    ja = get_localzone()
    mtg_start_time = mtg_start_time.astimezone(ja)

    # リモート会議生成
    mtg_id = client.CreateMeeting(topic='api test',
                                start_time=mtg_start_time,
                                duration_min=duration_min,
                                pass_code = 'test',
                                contact_name = 'icebreak',
                                contact_email = 'icebreak_mt1@itresourcetech.net')


    # 
    #  リモート会議招待テキストを取得する
    #
    invitation = client.GetInvitation(mtg_id)
    pprint(invitation)


    # 
    #  リモート会議情報を取得する
    #
    meeting = client.GetMeeting(mtg_id)
    pprint(meeting)
    

    # 
    #  リモート会議全リストを取得する
    #
    meeting_list=client.GetMeetingListAll()
    pprint(meeting_list)
    print(len(meeting_list))


    # 
    #  リモート会議の存在をチェックする
    #
    JST = tz.gettz('Asia/Tokyo')
    start_time=datetime.datetime(2022,6,6,16,30,tzinfo=JST)
    result= client.IsExistMeeting(meeting_list,start_time,60)
    print(result)

    # 
    #  リモート会議を削除する
    #
    result = client.DeleteMeeting(mtg_id)

ポイントは、以下の通りです。

１）HTTPリクエストのヘッダに、取得したトークンを設定する

APIキー（Client ID）とAPI秘密鍵（Client Secret）を使って、所定の形式のトークンを取得し、HTTPリクエストのヘッダに設定する必要があります。

    CONST_ZOOM_URL = 'https://api.zoom.us/v2'                           #  Zoom APIのURL
    CONST_ZOOM_API_KEY = 'XXXXXXXXXXXXXXXXXXXXXX'                       #  API key(Server-to-Server OAuth : client_id) 
    CONST_ZOOM_API_SECRET = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'          #  API secret(Server-to-Server OAuth : client_secret)
    CONST_ZOOM_USER_ID = 'user@test.org'                                # 主催者のメールアドレス
    CONST_ZOOM_TOKEN_EXPIRE_SEC = 600                                   # トークン有効期限：600秒


    # トークン取得メソッド
    def _GetToken(self):

        # endpoint to get invitationn text
        end_point = f"https://zoom.us/oauth/token"

        #  ベーシック認証設定（client id と client secretを設定）
        auth=HTTPBasicAuth(self.CONST_ZOOM_API_KEY, self.CONST_ZOOM_API_SECRET)

        #　ヘッダ生成
        headers = {'Host': 'zoom.us',
                   'Content-Type' : 'application/x-www-form-urlencoded'}

        data = 'grant_type=account_credentials'
        data += '&'
        data += 'account_id=8elTaiRVThOVdCsoL6AMPA'

        try:
            
            # リクエスト送信（生成：POST）
            response = requests.request('POST',
                                    end_point,
                                    headers=headers,
                                    data=data,
                                    auth=auth)

            # 次の形式のレスポンスのテキストをJSON形式に変換
            #{
            #      “Access_token“: String,
            #      “Token_type”: “bearer”,
            #      “Expire_in”: long,
            #      “scope” : [String]
            #}
            token_data = json.loads(response.text)
            self._token = token_data['access_token']
            return self._token

        except Exception as e:
            print(e)
            return None

    #  リクエストヘッダ生成メソッド
    def _GetHeaders(self,expire_sec: int):

        # トークン取得
        token=self._GetToken()
        if token is None:
            return None


        # トークンを設定し、ヘッダ(JSON)作成
        headers = {'Authorization': f"Bearer {self._token}",
                   'Content-Type': 'application/json'}

        return headers

２）会議時間には、タイムゾーンを指定する

リモート会議なので、参加者がどこにいてもインターネットさえつながれば会議できます。そのため、リモート会議を生成する際、会議時間は必ずタイムゾーンを指定する必要があります。


    # 
    #  リモート会議を生成する
    #

    # 　開始・終了時間　-->  開始時間、会議時間（分）に変換
    day = '2022/6/6'
    start_time = '16:30'
    end_time = '17:30'
    mtg_start_time = datetime.datetime.strptime(day + ' ' + start_time, '%Y/%m/%d %H:%M')
    mtg_end_time = datetime.datetime.strptime(day + ' ' + end_time, '%Y/%m/%d %H:%M')
    duration_min = int((mtg_end_time - mtg_start_time).seconds / 60)

    # 開始時間にTimeZone付与
    ja = get_localzone()
    mtg_start_time = mtg_start_time.astimezone(ja)

    # リモート会議生成
    mtg_id = client.CreateMeeting(topic='api test',
                                start_time=mtg_start_time,
                                duration_min=duration_min,
                                pass_code = 'test',
                                contact_name = 'icebreak',
                                contact_email = 'icebreak_mt1@itresourcetech.net')

３）APIからリモート会議生成時に設定できるオプションと自アカウントで事前設定するオプションがある

以下のようなオプションがAPIから設定できます。

    #  デフォルト設定JSON生成メソッド
    def _CreateDefaultSettings(self,contact_name:str,contact_email:str):

        return {
            'host_video': True,             # start video when the host joins
            'participant_video': True,      # start video when the participants join
            'join_before_host': True,       # no host
            'jbh_time': 0,                  # Allow the participant to join the meeting at anytime.(デフォルトっぽい)
            'mute_upon_entry': True,        # mute paticipants upon entry
            'approval_type': 0,             # automatically approve
            'cn_meeting': False,            # host meeting in china
            'in_meeting': False,            # host meeting in india
            'watermark': False,             # add a watermark when viewing a shared screen
            'use_pmi': False,               # personal meeting id
            'registration_type': 1,         # The meeting's registration type
            'audio': "voip",                # How participants join the audio portion of the meeting
            'auto_recording': "none",       # The automatic recording settings
            'enforce_login': False,                     # enfoce login
            'waiting_room': False,                      # Whether to enable the Waiting Room feature if this values true,this disables the join_before_hosts setting
            'registrants_email_notification': False,    # Whether to sedn registants email notifications abount their registration approval cancellation or rejection
            'meeting_authentication': False,    # if true ,only authenticated users can join the meeting
            'contact_name': contact_name,       # The contact name for meeting registration
            'contact_email': contact_email}     # The contact email for meeting registration

他にも、参加者に画面共有を自動許可する設定などは、自アカウントの設定画面から事前に設定する必要があります。

４）Zoom REST APIの定義に従って、URLとHTTPのメソッドを設定する。

機能ごとにURLを使い分けます。その際、自アカウントのメールアドレスを指定する必要があります。
REST APIに沿って、使う機能毎にGET/POST/PATCH/DELETEのメソッドを指定する必要があります。

    #   
    #  リモート会議生成メソッド
    #
    def CreateMeeting(self, topic: str, start_time: datetime, duration_min: int,pass_code: str,contact_name:str,contact_email:str):

        # リモート会議作成用のURLを生成
        end_point =  f'/users/{self.CONST_ZOOM_USER_ID}/meetings'

        #　トークンのタイムアウト値を指定し、リクエストヘッダを生成
        headers = self._GetHeaders(self.CONST_ZOOM_TOKEN_EXPIRE_SEC)

        # パスコードが未指定なら自動生成する
        if not pass_code:
            pass_code = str(random.randint(100000, 999999))
        
        # 会議のデフォルトパラメータを設定
        default_setting = self._CreateDefaultSettings(contact_name,contact_email)

        # リクエストのボディ部を生成
        body = {
            "topic": topic, # 会議の題名（Invitationに含まれる）
            'type': 2,  # scheduled meeting
            "start_time": start_time.isoformat(),
            "duration": duration_min,
            "timezone": "Osaka, Sapporo, Tokyo",
            "password": pass_code,
            #"agenda": agenda,
            "settings": default_setting}

        try:
            # リクエスト送信（生成：POST）
            # This API has a daily rate limit of 100 requests per day. 
            # Therefore, only 100 Create a Meeting API requests are permitted within a 24 hour window for a user.
            response = requests.request('POST',
                                    self.CONST_ZOOM_URL + end_point,
                                    headers=headers,
                                    data=json.dumps(body)).json()

            # レスポンス(JSON)からデータ取得
            self._meeting_id = response['id']   # meeting id
            self._status = response['status']   # 会議の状態
            self._uuid = response['uuid']       # uuid
            self._meeting_json = response       # レスポンス全体

            return self._meeting_id

        except Exception as e:
            print(e)
            return None

５）すでに登録済の会議リストの複数ページ取得には、次ページ番号と次ページトークンを指定する

登録した会議がたくさんある場合、APIを使って会議リストを取得すると、次ページ用のページ番号とトークンが返却されます。次ページを取得する場合、これらを指定して取得する必要があります。


    #
    #  リモート会議リスト取得メソッド
    #
    def GetMeetingList(self,next_page_token,page_number):

        # リモート会議リスト取得用のURLを生成
        end_point =  f'/users/{self.CONST_ZOOM_USER_ID}/meetings'

        # 取得するタイプに”スケジュール”、１ページ当たりの取得件数を100件で指定
        params =  '?type=scheduled&page_size=100'
        #params =  '?type=scheduled&page_size=1'

        # 次ページの取得の場合、次ページ用トークンとページ番号を指定
        if len(next_page_token) > 0:
            params += '&next_page_token='+ next_page_token
        if len(page_number) > 0:
            params += '&page_number='+ page_number

        #　トークンのタイムアウト値を指定し、リクエストヘッダを生成
        headers = self._GetHeaders(self.CONST_ZOOM_TOKEN_EXPIRE_SEC)

        # リクエスト送信（取得：GET）
        return requests.request("GET",
                                self.CONST_ZOOM_URL + end_point + params,
                                headers=headers).json()

    #
    #  リモート会議リストを全件取得するメソッド
    #
    def GetMeetingListAll(self):

        meetings=[]
        next_page_token = ''
        page_number = 1

        #  リモート会議リスト取得       
        response =self.GetMeetingList('','')

        # レスポンスのページ番号を取得
        if 'page_number' in response and  response['page_number'] != None:
            page_number=int(response['page_number'])

        # 次ページ用トークンを取得
        next_page_token=response['next_page_token']

        # 取得した会議情報を保存
        meetings.extend(response['meetings']) 

        # 全ページ分繰り返し
        while(next_page_token != None and len(next_page_token) > 0 ):

            #  リモート会議リスト取得                  
            response =self.GetMeetingList(next_page_token,str(page_number))

            # レスポンスのページ番号を取得
            if 'page_number' in response and  response['page_number'] != None:
                page_number=int(response['page_number'])
            #else:
            #    page_number += 1

            # 次ページ用トークンを取得
            next_page_token=response['next_page_token']

            # 取得した会議情報を保存
            meetings.extend(response['meetings']) 

        return meetings

６）WebHook機能を使うには、アカウントから事前にURLを指定しておく

WebHook機能とは、リモート会議生成・開始・終了・削除などが発生した際にZooｍサーバから自分のサーバのURLを呼び出してくれる機能です。
いわゆるコールバックですが、あらかじめアカウントからＵＲＬを設定しておく必要があります。また、呼び出してほしいイベントを指定しておく必要があります。

■　まとめ

一つのアカウントで同じ時間帯でダブルブッキングできません。同じ時間帯で会議を設定するには、複数のアカウントが必要になります。（有料アカウントでは、一つのアカウントで、「ホストを追加（有料）」することで対応できるようです）

ソフトウェア開発・システム開発業務/セキュリティ関連業務/ネットワーク関連業務/最新技術に関する業務など、「学習力×発想力×達成力×熱意」で技術開発の実現をサポート。お気軽にお問合せ下さい

メールでお問い合わせ

v3 game より:

2025年4月21日 2:26 PM

この記事は非常に役立ちました！Zoom REST APIのサーバー間OAuthの実践的な例は、実装を始める上での良い手引きになります。特に、具体的なコード例がありがたいです。引き続き、こうした実用的な情報を楽しみにしています！

返信
jaya slot より:

2025年5月3日 9:01 PM

この記事は非常に役立ちました！Zoom REST APIのサーバー間OAuthについて具体的な例があって分かりやすかったです。実際の開発に活かせそうです。情報をシェアしてくださり、ありがとうございます！

返信
91 Club App より:

2025年5月10日 11:50 PM

非常に役立つ内容でした！Zoom REST APIのServer-To-Server OAuthについての具体例がわかりやすく、実践での活用が楽しみです。これからのリモート会議の効率がさらに向上しそうです。ありがとうございます！

返信
banti Game Login より:

2025年5月11日 2:51 AM

この記事は非常に役立ちました！Zoom REST APIのServer-To-Server OAuthの実装方法が具体的に解説されていて、理解しやすかったです。実際にプロジェクトに活かしてみます。ありがとうございます！

返信
51 club より:

2025年6月3日 3:22 AM

非常に役立つ記事でした！Zoom REST APIの実装について具体的な手順が示されていて、とても理解しやすかったです。Server-To-Server OAuthの部分も詳しく解説されていて、実践に活かせそうです。ありがとうございました！

返信
L7 LOTTERY より:

2025年6月4日 3:40 PM

素晴らしい記事ですね！Zoom REST APIの実践入門として具体的な手順がわかりやすく説明されていて、とても助かりました。Server-To-Server OAuthについての理解も深まりました。今後のプロジェクトに活かしたいと思います。ありがとうございます！

返信
Winpkr より:

2025年6月7日 2:13 PM

このブログ記事は非常にわかりやすく、Zoom REST APIの実践的な使い方がよく理解できました。特にServer-To-Server OAuthの設定手順が明確で、実際の開発に役立ちそうです。今後もこのような実践的な内容を期待しています！ありがとうございます。

返信
gta 5 app より:

2025年6月7日 2:25 PM

非常にわかりやすい解説ですね！Server-To-Server OAuthの設定手順が丁寧に説明されていて、実践に役立ちそうです。特にAPIの具体例があると理解が深まります。ありがとうございます！

返信