カスタムAPI呼び出し(上級)

このピースでできること

  • Microsoft Outlook関連を含むMicrosoft Graph APIへ任意のHTTPリクエストを送れます。
  • カレンダー、連絡先、OneDriveなど、対応スコープ内のリソースにアクセスできます。

Microsoft Outlookの接続方法

1. 接続を作成

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

2. 接続設定

  • 接続名を設定して、「接続する」をクリックします。
 

3. Microsoft Outlookへのアクセス許可を与える

  • 管理者アカウントを選んでログインします。
  • アプリに許可を行います。

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

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

⚠️ Microsoft系アプリで管理者の同意が必要な場合

企業のMicrosoftセキュリティポリシーにより、外部アプリへのアクセス許可がブロックされている場合、接続時に以下のようなメッセージが表示されることがあります。
「workrunには、組織内のリソースへのアクセス許可が必要です。このアクセス許可を付与できるのは管理者のみです。」
この場合、貴社の情シス部門にMicrosoft Entra IDでの管理者同意(Admin Consent)の付与を依頼してください。
【標準のworkrun接続を利用している場合に、情シス担当者へ共有する情報】
  • アプリ表示名:workrun
  • クライアントID:f099e7f6-b923-41ce-9362-ee72073805f4
自社Azureアプリを利用している場合は、自社で登録したアプリの表示名とクライアントIDを共有してください。
管理者同意の具体的な手順は、以下のMicrosoft公式ドキュメントをご参照ください。
管理者同意の付与後、再度Microsoft Outlookへのアクセス許可を行ってください。

ピースの設定項目

1. URL(必須)

  • /me/ から始まるパスなど、呼び出したいAPIパスを指定します。

2. メソッド(必須)

  • HTTPメソッドを指定します。
  • f(動的値)をクリックすると任意で入力できます。

3. ヘッダー(必須)

  • 認証ヘッダーは接続から自動的に注入されます。
  • 追加のHTTPヘッダーをJSONで指定します。
  • f(動的値)をクリックすると任意で入力できます。

4. クエリパラメーター(必須)

  • URLに付与するパラメーターをJSONで指定します。
  • f(動的値)をクリックすると任意で入力できます。

5. ボディ(任意)

  • リクエストボディをJSONで指定します。
  • f(動的値)をクリックすると任意で入力できます。

6. 応答はバイナリですか?(任意)

  • PDF、画像などのファイルを有効にする場合はオンにします。
  • f(動的値)をクリックすると任意で入力できます。

7. 失敗時にエラーはありません(任意)

  • エラー時に空の結果を返す場合はオンにします。
  • f(動的値)をクリックすると任意で入力できます。

8. タイムアウト(秒)(任意)

  • タイムアウト時間をミリ秒で指定します。

9. 失敗時に続ける(任意)

  • このオプションを有効にすると、このステップをスキップし、失敗した場合は正常にフローを継続します。

10.失敗時に再試行(任意)

  • 失敗したときに自動的に最大 4 回の試行を再試行します。