Objets d'événement

Déclencheurs simples et déclencheurs installables permettent à Apps Script exécuter automatiquement une fonction si un certain événement se produit. Lorsqu'un déclencheur se déclenche, Apps Script transmet à la fonction un objet d'événement en tant qu'argument, généralement appelé e L'objet event contient des informations sur le contexte à l'origine de l'événement déclencher le déclenchement. L'exemple de code ci-dessous montre un élément onEdit(e) simple. pour un script Google Sheets qui utilise l'objet événement pour déterminer cellule a été modifiée.

function onEdit(e){
  // Set a comment on the edited cell to indicate when it was changed.
  var range = e.range;
  range.setNote('Last modified: ' + new Date());
}

Cette page détaille les champs de l'objet événement pour différents types déclencheurs.

Les événements générés par les déclencheurs installables contiennent triggerUid identifiant le déclencheur qui a généré l'événement. Cela est utile pour les scripts comportant plusieurs déclencheurs installables.

Événements Google Sheets

Les différents déclencheurs spécifiques à Google Sheets permettent aux scripts de répondre aux demandes d'un utilisateur des actions dans une feuille de calcul.

Ouvrir (simple et installable)
authMode	Valeur de l'énumération ScriptApp.AuthMode. LIMITED
source	Un Spreadsheet qui représente le fichier Google Sheets auquel le script est lié. Spreadsheet
triggerUid	ID du déclencheur ayant généré cet événement (déclencheurs installables uniquement). 4034124084959907503
user	Un objet User, représentant l'utilisateur actif, le cas échéant (en fonction d'un ensemble complexe de restrictions de sécurité). [e-mail]

Modifier (installable)
authMode	Valeur de l'énumération ScriptApp.AuthMode. FULL
changeType	Le type de modification (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT ou OTHER). INSERT_ROW
source	Un <ph type="x-smartling-placeholder"></ph> Spreadsheet qui représente le fichier Google Sheets dans lequel le script est liés. Spreadsheet
triggerUid	ID du déclencheur qui a généré cet événement. 4034124084959907503
user	Un objet User, représentant l'utilisateur actif, le cas échéant (en fonction d'un ensemble complexe de restrictions de sécurité). [e-mail]

Modifier (simple et installable)
authMode	Valeur de l'énumération ScriptApp.AuthMode. LIMITED
oldValue	Valeur de la cellule avant la modification, le cas échéant. Disponible uniquement si l'élément plage est une cellule unique. Ne sera pas défini si la cellule n'avait aucun précédent contenus. 1234
range	Un objet Range, représentant la cellule ou la plage de cellules qui ont été modifiées. Range
source	Un Spreadsheet qui représente le fichier Google Sheets auquel le script est lié. Spreadsheet
triggerUid	ID du déclencheur ayant généré cet événement (déclencheurs installables uniquement). 4034124084959907503
user	Un objet User, représentant l'utilisateur actif, le cas échéant (en fonction d'un ensemble complexe de restrictions de sécurité). [e-mail]
value	Nouvelle valeur de cellule après la modification. Disponible uniquement si la plage modifiée est une une seule cellule. 10

Envoi de formulaire (installable)
<ph type="x-smartling-placeholder"> </ph> Attention:Veillez à utiliser ce déclencheur d'envoi de formulaire avec SpreadsheetTriggerBuilder.
authMode	Valeur de l'énumération ScriptApp.AuthMode. FULL
namedValues	Objet contenant les noms et les valeurs des questions issues de l'envoi du formulaire. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] }
range	Un objet Range, représentant la cellule ou la plage de cellules qui ont été modifiées. Range
triggerUid	ID du déclencheur qui a généré cet événement. 4034124084959907503
values	Tableau contenant les valeurs dans le même ordre que celui dans lequel elles apparaissent dans la feuille de calcul. ['2015/05/04 15:00', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

Événements Google Docs

Les déclencheurs permettent à Google Docs de répondre lorsqu'un utilisateur ouvre un document.

Ouvrir (simple et installable)
authMode	Valeur de l'énumération ScriptApp.AuthMode. LIMITED
source	Un objet Document, représentant le fichier Google Docs auquel le script est lié. Document
triggerUid	ID du déclencheur ayant généré cet événement (déclencheurs installables uniquement). 4034124084959907503
user	Un objet User, représentant l'utilisateur actif, le cas échéant (en fonction d'un ensemble complexe de restrictions de sécurité). [e-mail]

Événements Google Slides

Les déclencheurs permettent à Google Slides de répondre lorsqu'un utilisateur ouvre une présentation.

Ouvrir (simple)
authMode	Valeur de l'énumération ScriptApp.AuthMode. LIMITED
source	Un objet Presentation, représentant le fichier Google Slides auquel le script est lié. Presentation
user	Un objet User, représentant l'utilisateur actif, le cas échéant (en fonction d'un ensemble complexe de restrictions de sécurité). [e-mail]

Événements Google Forms

Les déclencheurs spécifiques à Google Forms permettent aux scripts de répondre lorsqu'un utilisateur modifie un formulaire. ou envoie une réponse.

Ouvrir * (simple et installable)
authMode	Valeur de l'énumération ScriptApp.AuthMode. LIMITED
source	Un objet Form, représentant le fichier Google Forms auquel le script est lié. Form
triggerUid	ID du déclencheur ayant généré cet événement (déclencheurs installables uniquement). 4034124084959907503
user	Un objet User, représentant l'utilisateur actif, le cas échéant (en fonction d'un ensemble complexe de restrictions de sécurité). [e-mail]

* Cet événement ne se produit pas lorsqu'un utilisateur ouvre un formulaire pour répondre. lorsqu'un éditeur ouvre le formulaire pour le modifier.

Envoi de formulaire (installable)
<ph type="x-smartling-placeholder"> </ph> Attention:Veillez à utiliser ce déclencheur d'envoi de formulaire avec FormTriggerBuilder.
authMode	Valeur de l'énumération ScriptApp.AuthMode. FULL
response	Un objet FormResponse, représentant la réponse de l'utilisateur au formulaire dans son ensemble. FormResponse
source	Un objet Form, représentant le fichier Google Forms auquel le script est lié. Form
triggerUid	ID du déclencheur qui a généré cet événement. 4034124084959907503

Événements Google Agenda

Les déclencheurs d'agenda se déclenchent lorsque les événements d'agenda d'un utilisateur sont mis à jour (création, modifiées ou supprimées).

Ces déclencheurs n'indiquent pas quel événement a changé ni dans quelle mesure. Au lieu de cela, ils indiquent que votre code doit effectuer une opération de synchronisation incrémentielle pour récupérer les dernières modifications apportées à l'agenda. Pour obtenir une description complète de cette procédure, consultez les Guide sur la synchronisation des ressources pour la classe API Calendar :

Pour effectuer la synchronisation avec Agenda dans Apps Script, procédez comme suit:

1. Activez le service avancé Agenda pour le projet de script. L'API Le service Agenda ne suffit pas pour ce workflow.
2. Déterminez quels agendas doivent être synchronisés. Pour chacun de ces agendas, effectuer une synchronisation initiale ; à l'aide de la fonction Events.list().
3. Le résultat de la synchronisation initiale renvoie un nextSyncToken pour cet agenda. Stockez ce jeton pour une utilisation ultérieure.
4. Lorsque le déclencheur Apps Script EventUpdated s'exécute pour indiquer un agenda la modification d'un événement, effectuez une synchronisation incrémentielle. pour l'agenda concerné à l'aide du nextSyncToken stocké. C'est essentiellement une autre méthode Events.list(). requête, mais le fait d'indiquer nextSyncToken limite la réponse à seulement les événements qui ont été modifiés depuis la dernière synchronisation.
5. Examinez la réponse de la synchronisation pour savoir quels événements ont été mis à jour et pour que votre code réponde de manière appropriée. Par exemple, vous pouvez enregistrer la modification, mettre à jour une feuille de calcul, envoyer des notifications par e-mail ou effectuer d’autres actions.
6. Remplacez le nextSyncToken que vous avez stocké pour cet agenda avec celui renvoyé par la requête de synchronisation incrémentielle. Cela force la prochaine opération de synchronisation à ne renvoie que les modifications les plus récentes.

Attention :Il arrive que le serveur invalide les jetons de synchronisation, ce qui peut entraîner une 410 erreur. Dans ce cas, votre code doit effectuer une synchronisation complète et remplacer l'ensemble des données synchronisées et des jetons stockés pour cet agenda.

EventUpdated (installable)
authMode	Une valeur issue de ScriptApp.AuthMode enum. FULL
calendarId	Identifiant de chaîne de l'agenda dans lequel la mise à jour de l'événement a eu lieu. [e-mail]
triggerUid	ID du déclencheur qui a généré cet événement. 4034124084959907503

Événements du module complémentaire Google Workspace

Le déclencheur onInstall() s'exécute automatiquement lorsqu'un utilisateur installe un module complémentaire.

Installer (simple)
authMode	Valeur de l'énumération ScriptApp.AuthMode. FULL

Événements de l'application Google Chat

Pour en savoir plus sur les objets d'événement dans Google Chat, consultez Recevoir des interactions avec l'application Google Chat et y répondre

Événements temporels

Déclencheurs temporels (également appelés déclencheurs d'horloge) permettent aux scripts de s'exécuter à un moment précis un intervalle récurrent.

En fonction du temps (installable)
authMode	Valeur de l'énumération ScriptApp.AuthMode. FULL
day-of-month	Entre le 1 et le 31. Comme ce nom de propriété contient des tirets, vous devez y accéder via e['day-of-month'] plutôt que la notation par points. 31
day-of-week	Entre 1 (lundi) et 7 (dimanche). Comme ce nom de propriété contient des tirets, vous devez y accéder via e['day-of-week'] plutôt que la notation par points. 7
hour	Entre le 0 et le 23. 23
minute	Entre le 0 et le 59. 59
month	Entre le 1 et le 12. 12
second	Entre le 0 et le 59. 59
timezone	Fuseau horaire UTC
triggerUid	ID du déclencheur qui a généré cet événement. 4034124084959907503
week-of-year	Entre le 1 et le 52. Comme ce nom de propriété contient des tirets, vous devez y accéder via e['week-of-year'] plutôt que la notation par points. 52
year	L'année 2015