Adalo アプリで使えるZoom のデータ連携用のバックエンドAPI をノーコードで開発

杉本和也
リードエンジニア

ノーコードツールAdalo から Zoom のデータに接続するためのバックエンドAPI Server をCData API Server で構築

CData API Server を使って、Adalo から Zoom に接続してデータを取得する方法を説明します。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなZoom OData サービスを作成していきましょう。

Zoom への接続

Adalo からZoom のデータを操作するには、まずZoom への接続を作成・設定します。

API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Zoom」を選択します。
事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
CData コネクタの追加方法はこちら >>
それでは、Zoom への接続設定を行っていきましょう！
まず、Profile 接続プロパティにZoom プロファイルのディスク上の場所を設定します（例：C:\profiles\Zoom.apip）。次に、ProfileSettings 接続プロパティにZoom の接続文字列を設定します（以下を参照）。

Zoom API プロファイル設定

Zoom に認証するには、OAuth 標準を使用して自分のデータに接続したり、他のユーザーが自分のデータに接続できるようにします。

まず、OAuth アプリを作成します。https://marketplace.zoom.us/develop/create に移動し、OAuth セクションのCreate をクリックします。アプリが個々のユーザー用かアカウント全体用かを選択し、アプリを公開するためのボックスのチェックを外します。アプリに名前を付けてCreate をクリックします。その後、Client Secret とClient ID が提供されます。
以下の接続プロパティを設定すると、接続の準備が整います：
- AuthScheme：OAuth に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
- OAuthClientID：アプリ設定で指定されているOAuth Client ID を設定します。
- OAuthClientSecret：アプリ設定で指定されているOAuth Client Secret を設定します。
- CallbackURL：アプリ設定で指定したRedirect URI を設定します。
接続情報の入力が完了したら、「保存およびテスト」をクリックします。

まず、Profile 接続プロパティにZoom プロファイルのディスク上の場所を設定します（例：C:\profiles\Zoom.apip）。次に、ProfileSettings 接続プロパティにZoom の接続文字列を設定します（以下を参照）。

Zoom API プロファイル設定

Zoom に認証するには、OAuth 標準を使用して自分のデータに接続したり、他のユーザーが自分のデータに接続できるようにします。

まず、OAuth アプリを作成します。https://marketplace.zoom.us/develop/create に移動し、OAuth セクションのCreate をクリックします。アプリが個々のユーザー用かアカウント全体用かを選択し、アプリを公開するためのボックスのチェックを外します。アプリに名前を付けてCreate をクリックします。その後、Client Secret とClient ID が提供されます。

以下の接続プロパティを設定すると、接続の準備が整います：

AuthScheme：OAuth に設定します。
InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
OAuthClientID：アプリ設定で指定されているOAuth Client ID を設定します。
OAuthClientSecret：アプリ設定で指定されているOAuth Client Secret を設定します。
CallbackURL：アプリ設定で指定したRedirect URI を設定します。

API Server のユーザー設定

次に、API Server 経由でZoom にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

Zoom 用のAPI エンドポイントの作成

ユーザーを作成したら、Zoom のデータ用のAPI エンドポイントを作成していきます。

まず、「API」ページに移動し、「テーブルを追加」をクリックします。
アクセスしたい接続を選択し、次へをクリックします。
接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でZoom への接続を設定してユーザーを作成し、API Server でZoom データのAPI を追加しました。これで、OData 形式のZoom データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

オンプレミスDB やファイルからのAPI Server 使用（オプション）

オンプレミスRDB やExcel/CSV などのファイルのデータを使用する場合には、API Server のCloug Gateway / SSH ポートフォワーディングが便利です。是非、Cloud Gatway の設定方法記事を参考にしてください。

Adalo でアプリを作成する

CData API Server 側の準備が完了したら、早速Adalo 側でアプリ開発を開始します。

「CREATE NEW APP」をクリックし

今回は「Desktop Web App」を作成します。

template を最初に選ぶことができますが、今回は検証用なので何も無い「Blank」で作成しました。

最後にアプリ名とカラーリング設定を選んで、アプリの準備は完了です。

External Collections の登録

続いてCData API Server への接続をAdalo に追加します。Adalo では「Collection」という形でデータ構造を持ち、アプリのデータを管理することができるのですが、この「Collection」を外部のAPIとシームレスに連携した形で利用することができる「External Collections with APIs」という機能があります。この機能を用いてCData API Server に接続します。

アプリを作成したら、まず Adalo アプリ内でデータを扱うための定義である「Collection」を登録します。Collection は Adalo 内部の独自DB のような「Database Collections」と、外部のAPI に対してシームレスにアクセスすることが可能な「External Collections」があります。今回は外部のAPI に対してアクセスを行うので「External Collections」で登録します。

External Collections の登録画面では最初にコレクション名とAPI のベースとなるURL エンドポイントを指定します。任意のCollection 名とAPI Base URL に先程CData API Server で登録したZoom の対象リソースに接続できるOData のエンドポイントを指定します。併せて認証情報として Header に「x-cdata-authtoken」の名前でCData API Server ユーザー登録時に生成されているTokenを指定します。

続いてAdalo から実行されるそれぞれのリクエストの関連付けを行います。通常のAPI であれば様々なチューニングが必要となる箇所ですが、Zoom ではほぼデフォルトの設定のままで進められます。一点だけ設定が必要な箇所として、Zoom からのレスポンスをレコード単位で識別するために「Get All」の設定にある「Results Key」に「value」を登録しておくことが挙げられます。これを設定したら「Next」をクリックしましょう。