Le service Agenda avancé vous permet d'utiliser l'API Google Agenda publique dans Apps Script. Tout comme le service Agenda intégré d'Apps Script, cette API permet aux scripts d'accéder à Google Agenda et de les modifier, y compris les agendas supplémentaires auxquels l'utilisateur est abonné. Dans la plupart des cas, le service intégré est plus facile à utiliser, mais ce service avancé fournit quelques fonctionnalités supplémentaires, y compris la définition de la couleur d'arrière-plan pour des événements individuels.
Reference
Pour en savoir plus sur ce service, consultez la documentation de référence de l'API publique Google Calendar. Comme tous les services avancés d'Apps Script, le service Agenda avancé utilise les mêmes objets, méthodes et paramètres que l'API publique. Pour en savoir plus, consultez la section Comment les signatures de méthode sont-elles déterminées ?
Pour signaler des problèmes et obtenir de l'aide, consultez le guide d'assistance relatif à Agenda.
En-têtes de requêtes HTTP
Le service Agenda avancé peut accepter les en-têtes de requête HTTP If-Match
et If-None-Match
. Pour en savoir plus, consultez la documentation de référence.
Exemple de code
L'exemple de code ci-dessous utilise la version 3 de l'API.
Créer des événements
L'exemple suivant montre comment créer un événement dans l'agenda par défaut de l'utilisateur.
Répertorier les agendas
L'exemple suivant montre comment récupérer les détails des agendas affichés dans la liste des agendas de l'utilisateur.
Répertorier les événements
L'exemple suivant montre comment répertorier les 10 prochains événements à venir dans l'agenda par défaut de l'utilisateur.
Modifier un événement de manière conditionnelle
L'exemple suivant montre comment mettre à jour un événement Agenda de manière conditionnelle à l'aide de l'en-tête If-Match
. Le script crée un événement, attend 30 secondes, puis ne met à jour l'événement que si les détails de l'événement n'ont pas changé depuis sa création.
Récupérer un événement de manière conditionnelle
L'exemple suivant montre comment extraire de manière conditionnelle un événement d'agenda à l'aide de l'en-tête If-None-Match
. Le script crée un événement, puis interroge l'événement pour détecter les modifications pendant 30 secondes. Chaque fois que l'événement change, la nouvelle version est récupérée.
Synchroniser les événements
L'exemple suivant montre comment récupérer des événements à l'aide de jetons de synchronisation. Lorsque vous incluez un jeton de synchronisation dans une requête de service avancée Agenda, la réponse obtenue n'inclut que les éléments qui ont été modifiés depuis la génération de ce jeton, ce qui permet un traitement plus efficace. Pour en savoir plus sur le processus de synchronisation, consultez la page Synchroniser les ressources de manière efficace.
L'exemple suivant utilise la même méthode getRelativeDate(daysOffset, hour)
que celle définie dans les exemples ci-dessus.