Rappels et notifications

L'API Calendar est compatible avec les rappels et les notifications.

  • Les rappels sont des alarmes déclenchées à un moment précis avant le début d'un événement.
  • Les notifications permettent aux utilisateurs d'être informés des modifications apportées aux événements de leur agenda.

Ne confondez pas ce dernier élément avec le protocole push. des notifications qui, au lieu d'être diffusées, à un utilisateur, notifier un autre serveur des modifications apportées à un agenda.

Pour en savoir plus sur les notifications dans Google Agenda, consultez Modifiez les notifications Google Agenda.

Rappels

Un rappel se compose des éléments suivants:

  • Quand afficher le rappel, exprimé en minutes avant le début de l'événement
  • Mode de diffusion à utiliser (voir la section Mécanismes de diffusion)

Vous pouvez définir des rappels pour des agendas entiers ou pour des événements spécifiques. Utilisateurs définir des rappels par défaut pour chacun de leurs agendas ; ces valeurs par défaut s'appliquent tous les événements de cet agenda. Toutefois, les utilisateurs peuvent aussi ignorer ces des valeurs par défaut pour des événements individuels, en les remplaçant par un autre rappels.

Rappels par défaut

Les rappels sont des informations privées spécifiques à un utilisateur authentifié. ils sont pas partagés entre plusieurs utilisateurs. Par conséquent :

  • Les rappels par défaut sont manipulés via la collection CalendarList, qui contient des métadonnées d'agenda spécifiques à l'utilisateur.
  • Ils ne sont pas accessibles via la collection "Agendas", qui contient des informations sont partagées entre tous les utilisateurs.

Des rappels par défaut sont également renvoyés lors de l'exécution d'une requête de liste d'événements.

Remplacer les rappels par défaut

Pour ignorer les rappels par défaut lorsque vous insérez ou modifiez un événement, définissez reminders.useDefault à false et insérer reminders.overrides avec le nouveau rappel défini.

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

Pour rétablir l'ensemble de rappels par défaut, modifiez le paramètre reminders.useDefault à true.

Notifications

Agenda est compatible avec les types de notifications suivants:

  • Création d'un événement: un événement est ajouté à l'un des agendas de l'utilisateur.
  • Modification d'un événement: l'organisateur a modifié un événement auquel l'utilisateur était invité.
  • Annulation de l'événement: l'événement est annulé. L'utilisateur y a été invité.
  • Réponse des participants: un participant à un événement créé par l'utilisateur a modifié l'état de sa réponse.
  • Agenda: liste de tous les événements de l'agenda de l'utilisateur, envoyée au début de la journée.

L'utilisateur peut choisir les notifications à activer pour chaque agenda et la fréquence de diffusion. pour chaque type de notification. Ces paramètres ne sont pas partagés avec d'autres utilisateurs. Comme les rappels par défaut, ils sont accessibles CalendarList.

Pour envoyer des notifications par e-mail aux participants concernant les événements ajoutés ou mis à jour via l'API, définissez le paramètre sendNotifications dans le champ "insert/update" sur "true".

Mécanismes de distribution

Google Agenda propose les modes d'envoi suivants:

  • Pop-up. Ils sont pris en charge sur les plates-formes mobiles et les clients Web.
  • E-mail envoyé par le serveur.

Le tableau suivant présente les méthodes acceptées pour chaque type de rappel ou de notification:

Pop-up E-mail
Rappels Rappels par défaut ✓ ✓
Ignorer les rappels ✓ ✓
Notifications Création d'événements ❌ ✓
Changement d'événement ❌ ✓
Annulation de l'événement ❌ ✓
Réponse des participants ❌ ✓
Sommaire ❌ ✓