Le service Agenda avancé vous permet d'utiliser l'API Google Calendar publique dans Apps Script. Tout comme le service Agenda intégré d'Apps Script, cette API permet aux scripts d'accéder à l'agenda Google de l'utilisateur et de le modifier, y compris les agendas supplémentaires auxquels celui-ci 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 Google Agenda publique. 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 Agenda.
En-têtes de requête 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 de manière conditionnelle un événement Agenda à l'aide de l'en-tête If-Match
. Le script crée un événement, attend 30 secondes, puis le met à jour uniquement si aucun détail n'a été modifié depuis sa création.
Récupérer un événement de manière conditionnelle
L'exemple suivant montre comment récupérer de manière conditionnelle un événement Agenda à l'aide de l'en-tête If-None-Match
. Le script crée un événement, puis l'interroge pendant 30 secondes pour déterminer si des modifications y ont été apportées. Chaque fois que l'événement change, la nouvelle version est récupérée.
Synchronisation des é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é Agenda, la réponse qui s'affiche n'inclut que les éléments qui ont été modifiés depuis la génération du jeton, ce qui permet un traitement plus efficace. Consultez la section Synchroniser les ressources efficacement pour en savoir plus sur le processus de synchronisation.
L'exemple suivant utilise la même méthode getRelativeDate(daysOffset, hour)
que celle définie dans les exemples ci-dessus.