Guide

カレンダーイベントにビデオ会議を追加する

参加リンクのない会議では、参加者が別の場所に行ってしまいます。プロバイダー API で会議機能を追加するには、Google の conferenceData、Microsoft の onlineMeeting、それぞれ別の実装が必要です。Nylas CLI なら、イベント作成時に 1 つのフラグでビデオリンクを追加でき、そのリンクは各参加者が受け取る招待にも含まれます。このガイドでは、会議リンクの追加、リンクが入ったことの確認、スケジューリングスクリプトでの利用方法を説明します。

Written by Prem Keshari Senior SRE

Verified — CLI 3.1.16 · Gmail, Outlook · last tested June 8, 2026

このガイドで使うコマンドリファレンス: nylas calendar events create、 nylas calendar events show、 nylas calendar find-time。

カレンダーイベントに会議リンクを追加するには？

nylas calendar events create でイベントを作成するときに --meeting-link を渡すと、会議リンクを追加できます。プロバイダーがビデオリンクを生成し — Google アカウントでは Google Meet、Microsoft ではオンライン会議 — イベントに添付し、各参加者が受け取る招待にも含めます。1 つのフラグで、手作業で作る必要があったプロバイダー固有の会議 payload を置き換えられます。

これを直接実装するとプロバイダー固有の作業になります。Google の API では conferenceData の作成リクエストが必要で、Microsoft Graph は Microsoft Graph のオンライン会議ドキュメントに従って、onlineMeetingProvider とともに isOnlineMeeting を設定します。CLI はその両方を 1 つのフラグの裏で正規化するため、主催者が Google でも Outlook でもコマンドは同じです。

# 生成されたビデオ会議リンク付きでイベントを作成する
nylas calendar events create \
  --title "Design review" \
  --start 2026-06-18T16:00:00Z \
  --end 2026-06-18T16:45:00Z \
  --participants alice@example.com,bob@example.com \
  --meeting-link

リンクが追加されたことを確認するには？

nylas calendar events show --id EVENT_ID --json でイベントを読み戻し、会議ブロックを確認します。参加 URL は conferencing.details.url にあるため、1 行の jq フィルターで参加者が実際にクリックするリンクだけを出力できます。このフィールドが埋まっていれば、リンクはイベントと招待に入っています。

これは、URL を取得して Slack リマインダー、チケット、確認メールなど別の場所に投稿したい自動化で重要です。イベント作成直後に JSON から URL を取り出して後続処理で再利用すれば、メッセージ内のリンクはプレースホルダーではなく、カレンダーが生成した実際のリンクになります。

# イベントから生成された参加 URL を読み取る
nylas calendar events show --id event_abc123 --json \
  | jq -r '.conferencing.details.url'

スケジューリングスクリプトで会議リンクを追加するには？

スクリプトでは、空き時間の検索から作成までをつなげます。nylas calendar find-time で空き枠を見つけ、--meeting-link 付きでイベントを作成し、会議 URL を読み戻して独自の確認メッセージに含めます。これにより、“リンク付きの通話を予約する” が 3 つのコマンドになり、すべてプロバイダー非依存なので、同じフローで Google と Outlook の参加者に対応できます。

会議 URL はログや公開チャンネルに出さないでください — これは参加リンクであり、持っている人なら誰でも会議に入れます。JSON から取得し、参加者だけに送信し、他のアクセス認証情報と同じように扱います。定期的な通話では、毎週新しいリンクを作るのではなく、シリーズを一度作成してリンクを再利用します。

# 枠を見つけ、リンク付きで作成し、URL を取得する
slot_start=2026-06-19T14:00:00Z
slot_end=2026-06-19T14:30:00Z

id=$(nylas calendar events create \
  --title "Intro call" --start "$slot_start" --end "$slot_end" \
  --participants client@example.com --meeting-link --json | jq -r '.id')

url=$(nylas calendar events show --id "$id" --json | jq -r '.conferencing.details.url')
echo "Join link: $url"

次のステップ