予定の取得

このピースでできること

  • TimeRexのカレンダーに登録されたイベント(予定)の一覧を取得します。
  • 開始・終了日時で絞り込むことができ、10件以上ある場合はページネーションにも対応しています。

TimeRex の接続方法

workrun と TimeRex を接続するには、TimeRex の API キー が必要です。

ステップ 1:API キーを取得する

  1. TimeRex にログインします。
  1. 画面右上のアイコンから 「チーム設定」 を開きます。
  1. 左メニューから 「デベロッパーツール」 を選択します。
  1. 「TimeRex 日程調整API」 のセクションで「APIキーを発行」をクリックします。
  1. 生成された API キーをコピーします。
      • APIアクセスが有効になっていない場合は、「APIアクセスを有効化」のトグルをオンにしてからAPIキーを発行してください。

ステップ 2:workrun に接続を追加する

  1. workrun で TimeRex のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 「API Key」 フィールドに、ステップ 1 でコピーした API キーを貼り付けます。
  1. 「保存」 をクリックして接続を完了します。

ピースの設定項目

1. カレンダー(必須)

  • 取得対象のカレンダーをドロップダウンから選択してください。チームに紐づくカレンダーが最大300件表示されます。

2. 検索期間の開始日時(任意)

  • 取得するイベントの開始日時をISO 8601形式で入力します。省略した場合は期間の制限なしで取得します。

3. 検索期間の終了日時(任意)

  • 取得するイベントの終了日時をISO 8601形式で入力します。省略した場合は期間の制限なしで取得します。

4. 次ページ取得用トークン(任意)

  • 10件以上のイベントがある場合、前回のレスポンスに含まれる nextPageToken を入力することで次のページのデータを取得できます。最初の取得時は空欄のままにしてください。