リマインダーと通知

Calendar API はリマインダーと通知をサポートしています。

• リマインダーは、イベントが始まる前の指定された時間にトリガーされるアラームです。
• 通知を使用すると、カレンダーの予定に変更があったときに通知を受け取ることができます。

後者の項目を push と混同しないでください。 通知により、Google グループに カレンダーの変更を別のサーバーに通知します。

Google カレンダーの通知について詳しくは、以下をご覧ください。 Google カレンダーの通知設定を変更する

リマインダー

リマインダーは以下の要素で構成されます。

• リマインダーを表示するタイミング（イベント開始時間の分単位）
• 使用する配信方法（配信メカニズムを参照）

リマインダーは、カレンダー全体に対して指定することも、個々の予定に対して指定することもできます。ユーザー 各カレンダーにデフォルトのリマインダーを設定する。これらのデフォルトは そのカレンダー内のすべての予定が表示されます。ただし、ユーザーはこれらの設定を 各イベントのデフォルトのイベント ラベルが、 できます。

デフォルトのリマインダー

リマインダーは、認証されたユーザーに固有の個人情報です。彼らは 共有されません。結果として次のようになります。

• デフォルトのリマインダーは、CalendarList コレクションを介して操作されます。 ユーザー固有のカレンダー メタデータを含みます。
• カレンダー コレクションからはアクセスできず、このコレクションにはグローバル すべてのユーザー間で共有されます。

イベントリストのクエリを実行すると、デフォルトのリマインダーも返されます。

デフォルトのリマインダーのオーバーライド

予定を挿入または変更するときにデフォルトのリマインダーをオーバーライドするには、 reminders.useDefault を false に設定し、 reminders.overrides 新しいリマインダーを設定します

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

リマインダーのデフォルト設定に戻すには、更新設定を行ってください reminders.useDefault true に戻ります。

通知

カレンダーは、次の通知タイプをサポートしています。

• 予定の作成: 新しい予定がユーザーのカレンダーのいずれかに追加されます。
• 予定の変更: ユーザーが招待された予定が主催者によって変更されました。
• 予定のキャンセル: ユーザーが招待された予定がキャンセルされます。
• 参加者の返答: ユーザーが作成した予定の参加者の返答ステータスが変更されました。
• 予定リスト: ユーザーのカレンダーのすべての予定のリスト。1 日の初めに送信されます。

ユーザーはカレンダーごとに有効にする通知や配信を決定できる メソッドを定義します。これらの設定は他の誰とも共有されません できます。デフォルトのリマインダーと同様に、 CalendarList コレクション。

挿入された予定のメール通知を参加者に送信するには、 API で更新する場合は、挿入/更新関数で sendNotifications パラメータを設定します。 true に設定します。

デリバリー メカニズム

Google カレンダーの配信方法には次のものがあります。

• ポップアップ:これらは、モバイル プラットフォームとウェブ クライアントでサポートされています。
• サーバーによって送信されるメール。

次の表に、リマインダーまたは通知の種類ごとにサポートされている方法を示します。