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 カレンダーの配信方法には次のものがあります。
- ポップアップ。これらは、モバイル プラットフォームとウェブ クライアントでサポートされています。
- サーバーによって送信されるメール。
次の表に、リマインダーまたは通知の種類ごとにサポートされている方法を示します。
ポップアップ | メール | ||
---|---|---|---|
リマインダー | デフォルトのリマインダー | ✓ | ✓ |
リマインダーをオーバーライドする | ✓ | ✓ | |
通知 | イベントの作成 | ❌ | ✓ |
イベントの変更 | ❌ | ✓ | |
イベントのキャンセル | ❌ | ✓ | |
参加者の回答 | ❌ | ✓ | |
アジェンダ | ❌ | ✓ |