カスタムAPIコール

このピースでできること

  • Zoom APIに対してカスタムリクエストを実行します。
  • 標準のピースでは提供されていないZoom APIの機能を利用できます。
  • HTTPメソッド、エンドポイント、ヘッダー、ボディなどを自由に設定できます。
 

Zoom の接続方法(workrunアプリを使う)

※こちらは現在準備中です。

1. 接続を作成

  • 接続から「接続を作成」をクリックします。

2. 接続名を任意に設定後、「接続する」をクリック

 

3. Zoomとアカウント認証する

Zoom の接続方法(個人でアプリを作成して接続)

1. 接続を作成

  • 接続から「接続を作成」をクリックします。

2. 接続設定

 
  • 「Develop > build app」をクリックをクリックします。
  • 「Agree」をクリックをクリックします。
  • 「General App」を選択して、「Create」をクリック
  • 「Basic Information」
    • 「App Credentials」にある「Client ID」と「Client Secret」をコピーして、workrun側に入力します。
    • 「OAuth Information」にある「OAuth Redirect URL」にWorkrun側の「リダイレクトURL」を設定します。
  • 「Scopes(アクセス権限)」
    • Zoom App Marketplaceで作成したアプリの「Scopes」から、workrunで利用する機能に応じて必要なアクセス権限を追加します。
    • 設定するスコープの例
      スコープ利用する機能
      Zoomミーティングを作成する場合
      ミーティングへの参加登録者を追加する場合
      Zoom Canvasのファイル検索を利用する場合
      上記はスコープの一例です。利用する機能やAPIによって必要なスコープは異なるため、必要に応じて追加してください。利用する機能に必要なスコープだけを設定してください。
      スコープの詳細は、Zoom公式ドキュメントをご確認ください。
    • Zoom公式:Granular scopes(スコープ一覧)
    • Zoom公式:OAuth scopes(スコープの種類と設定方法)
    • スコープを追加・変更した場合
      すでにworkrunとZoomを接続している場合は、スコープの変更後にworkrun側でZoom接続を再認証してください。
  • 「Local Test」
    • 「Add app now」をクリックします。
    • Zoomの権限確認画面が表示されるので「Allow」をクリックします。

3. 接続を保存

  • 「保存」を押して接続名が設定されていることを確認します。
 
 

ピースの設定項目

1. URL(必須)

  • Zoom APIのエンドポイントパスを入力します。

2. HTTPメソッド(必須)

  • HTTPメソッドを選択します。
  • 選択肢: GET、POST、PUT、PATCH、DELETE

3. ヘッダー(任意)

  • カスタムHTTPヘッダーを指定します。
  • オブジェクト形式で入力します。
  • 認証ヘッダーは自動的に付加されます。

4. ボディ(任意)

  • リクエストボディをJSON形式で入力します。
  • POSTやPUTリクエストで使用します。

5. クエリパラメータ(任意)

  • URLクエリパラメータを指定します。
  • オブジェクト形式で入力します。