Events: quickAdd

単純なテキスト文字列に基づいてイベントを作成します。実習をご覧ください。

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/quickAdd

パラメータ

パラメータ名 値 説明
パスパラメータ
calendarId string カレンダー ID。カレンダー ID を取得するには、calendarList.list メソッドを呼び出します。現在ログインしているユーザーのメイン カレンダーにアクセスするには、「primary」キーワードを使用します。
必須のクエリ パラメータ
text string 作成するイベントを説明するテキスト。
省略可能なクエリ パラメータ
sendNotifications boolean 非推奨です。代わりに sendUpdates を使用してください。

イベントの作成に関する通知を送信するかどうか。値を false に設定しても、一部のメールは送信される場合があります。デフォルトは false です。
sendUpdates string 新しい予定の作成に関する通知を受け取るゲスト。

有効な値は次のとおりです。
  • 「all」: すべてのゲストに通知が送信されます。
  • 「externalOnly」: 通知は Google カレンダー以外のゲストにのみ送信されます。
  • 「none」: 通知は送信されません。カレンダーの移行タスクの場合は、代わりに Events.import メソッドの使用を検討してください。

承認

このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。

範囲
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.owned

詳しくは、認証と認可のページをご覧ください。

リクエストの本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドはレスポンスの本文で Events リソースを返します。

試してみよう:

以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認します。