Ereignisobjekte

Einfache Trigger und installierbare Trigger ermöglichen Apps Script, eine Funktion automatisch ausführen, wenn ein bestimmtes Ereignis eintritt. Wenn ein Trigger ausgelöst wird, Apps Script übergibt der Funktion ein Ereignisobjekt als Argument. Dieses wird in der Regel e Das Ereignisobjekt enthält Informationen über den Kontext, der den Fehler verursacht hat. ausgelöst werden soll. Der folgende Beispielcode zeigt eine einfache onEdit(e). Trigger für ein Google Tabellen-Skript, das mithilfe des Ereignisobjekts bestimmt, Zelle wurde bearbeitet.

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());
}

Auf dieser Seite werden die Felder im Ereignisobjekt für verschiedene Arten von Trigger.

Google Tabellen-Ereignisse

Mit den verschiedenen Google Tabellen-spezifischen Triggern können Skripts auf die Antwort Aktionen in einer Tabelle.

Öffnen

(einfach und installierbar)
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

LIMITED
source

Spreadsheet -Objekt, das die Google Tabellen-Datei darstellt, an die das Skript gebunden ist.

Spreadsheet
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat (nur installierbare Trigger).

4034124084959907503
user

Ein User-Objekt der den aktiven Nutzer darstellt, falls verfügbar (je nach komplexen Sicherheitsbeschränkungen).

amin@example.com

Ändern

(installierbar)
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

FULL
changeType

Die Art der Änderung (EDIT, INSERT_ROW, INSERT_COLUMN, REMOVE_ROW, REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT oder OTHER).

INSERT_ROW
source

Ein Spreadsheet. -Objekt, das die Google Tabellen-Datei darstellt, in die das Skript geschrieben wird. gebunden.

Spreadsheet
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat.

4034124084959907503
user

Ein User-Objekt der den aktiven Nutzer darstellt, falls verfügbar (je nach komplexen Sicherheitsbeschränkungen).

amin@example.com

Bearbeiten

(einfach und installierbar)
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

LIMITED
oldValue

Zellenwert vor der Änderung, falls vorhanden. Nur verfügbar, wenn das bearbeitete ist eine einzelne Zelle. Ist nicht definiert, wenn die Zelle keine vorherigen Inhalte.

1234
range

Ein Range-Objekt die die bearbeitete Zelle oder den Zellenbereich darstellt.

Range
source

Spreadsheet -Objekt, das die Google Tabellen-Datei darstellt, an die das Skript gebunden ist.

Spreadsheet
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat (nur installierbare Trigger).

4034124084959907503
user

Ein User-Objekt der den aktiven Nutzer darstellt, falls verfügbar (je nach komplexen Sicherheitsbeschränkungen).

amin@example.com
value

Neuer Zellenwert nach der Bearbeitung. Nur verfügbar, wenn der bearbeitete Bereich ein in einer einzelnen Zelle.

10

Formular senden

(installierbar)
<ph type="x-smartling-placeholder">
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

FULL
namedValues

Ein Objekt, das die Fragennamen und -werte aus der Formulareinreichung enthält.

{
  'First Name': ['Jane'],
  'Timestamp': ['6/7/2015 20:54:13'],
  'Last Name': ['Doe']
}
range

Ein Range-Objekt die die bearbeitete Zelle oder den Zellenbereich darstellt.

Range
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat.

4034124084959907503
values

Array mit Werten in der Reihenfolge, in der sie in der Tabelle angezeigt werden.

['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill',
'28', 'Susan', '25']

Google Docs-Termine

Mithilfe von Triggern kann Google Docs antworten, wenn ein Nutzer ein Dokument öffnet.

Öffnen

(einfach und installierbar)
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

LIMITED
source

Ein Document-Objekt für die Google Docs-Datei, an die das Skript gebunden ist.

Document
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat (nur installierbare Trigger).

4034124084959907503
user

Ein User-Objekt der den aktiven Nutzer darstellt, falls verfügbar (je nach komplexen Sicherheitsbeschränkungen).

amin@example.com

Veranstaltungen zu Google Präsentationen

Mithilfe von Triggern kann Google Präsentationen antworten, wenn ein Nutzer eine Präsentation öffnet.

Öffnen

(einfach)
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

LIMITED
source

Ein Presentation-Objekt für die Google Präsentationen-Datei, an die das Skript gebunden ist.

Presentation
user

Ein User-Objekt der den aktiven Nutzer darstellt, falls verfügbar (je nach komplexen Sicherheitsbeschränkungen).

amin@example.com

Google Formulare-Ereignisse

Mit den Google Formulare-spezifischen Triggern können Skripts reagieren, wenn ein Nutzer ein Formular bearbeitet. oder sendet eine Antwort.

Öffnen

* (einfach und installierbar)
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

LIMITED
source

Ein Form-Objekt für die Google Formulare-Datei, an die das Skript gebunden ist.

Form
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat (nur installierbare Trigger).

4034124084959907503
user

Ein User-Objekt der den aktiven Nutzer darstellt, falls verfügbar (je nach komplexen Sicherheitsbeschränkungen).

amin@example.com

* Dieses Ereignis tritt nicht ein, wenn ein Nutzer ein Formular öffnet, um zu antworten. Ein Mitbearbeiter öffnet das Formular, um es zu ändern.

Formular senden

(installierbar)
<ph type="x-smartling-placeholder">
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

FULL
response

Ein FormResponse-Objekt die die Antwort des Nutzers auf das Formular als Ganzes darstellt.

FormResponse
source

Ein Form-Objekt für die Google Formulare-Datei, an die das Skript gebunden ist.

Form
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat.

4034124084959907503

Google Kalender-Termine

Kalender-Trigger werden ausgelöst, wenn Kalendertermine eines Nutzers aktualisiert (erstellt, bearbeitet oder gelöscht).

Diese Trigger geben keinen Aufschluss darüber, welches Ereignis geändert wurde oder wie es sich geändert hat. Stattdessen geben sie an, dass Ihr Code eine inkrementelle Synchronisierung durchführen muss. um kürzlich vorgenommene Änderungen am Kalender zu übernehmen. Für eine vollständige Beschreibung finden Sie in der Leitfaden zum Synchronisieren von Ressourcen für den Kalender API

Gehen Sie wie folgt vor, um in Apps Script mit Google Kalender zu synchronisieren:

  1. Aktivieren Sie den erweiterten Dienst Google Kalender für des Skriptprojekts. Die integrierte Kalenderdienst reicht nicht aus, in diesem Workflow.
  2. Bestimmen Sie, welche Kalender synchronisiert werden sollen. Für jeden dieser Kalender erste Synchronisierung mithilfe der Funktion Events.list().
  3. Das Ergebnis der ersten Synchronisierung gibt ein nextSyncToken für diesen Kalender zurück. Speichern Sie dieses Token zur späteren Verwendung.
  4. Wenn der Apps Script-Trigger EventUpdated für einen Kalender ausgelöst wird Ereignisänderung, führen Sie eine inkrementelle Synchronisierung durch. für den betroffenen Kalender mithilfe der gespeicherten nextSyncToken. Dies ist im Grunde ein weiteres Events.list() -Anfrage, aber mit dem nextSyncToken ist die Antwort nur auf Termine, die sich seit der letzten Synchronisierung geändert haben.
  5. Prüfen Sie die Antwort auf die Synchronisierung, um zu erfahren, welche Ereignisse aktualisiert wurden und dass Ihr Code entsprechend reagiert. Sie können beispielsweise die Änderung protokollieren, eine Tabelle aktualisieren, E-Mail-Benachrichtigungen senden oder andere Aktionen ausführen.
  6. Aktualisieren Sie die nextSyncToken, die Sie für diesen Kalender gespeichert haben, durch den zurückgegebenen Wert. durch die Anfrage zur inkrementellen Synchronisierung. Dadurch wird der nächste Synchronisierungsvorgang erzwungen, nur die aktuellsten Änderungen zurückgeben.

EventUpdated

(installierbar)
authMode

Ein Wert aus dem ScriptApp.AuthMode enum.

FULL
calendarId

Die String-ID des Kalenders, in dem das Ereignis aktualisiert wurde.

susan@example.com
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat.

4034124084959907503

Ereignisse zu Google Workspace-Add-ons

Der onInstall()-Trigger wird ausgeführt automatisch, wenn ein Nutzer ein Add-on installiert.

Installieren

(einfach)
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

FULL

Google Chat App-Ereignisse

Weitere Informationen zu Ereignisobjekten in Google Chat finden Sie unter Interaktionen mit der Google Chat App empfangen und beantworten

Zeitgesteuerte Ereignisse

Zeitgesteuerte Trigger (auch Timer-Trigger genannt) ermöglichen die Ausführung von Skripts zu einer bestimmten Zeit wiederkehrendes Intervall.

Zeitgesteuert (installierbar)
authMode

Ein Wert aus der ScriptApp.AuthMode-Enum.

FULL
day-of-month

Zwischen 1 und 31.

Da dieser Property-Name Bindestriche enthält, muss darauf zugegriffen werden: e['day-of-month'] statt Punktnotation.

31
day-of-week

Zwischen 1 (Montag) und 7 (Sonntag).

Da dieser Property-Name Bindestriche enthält, muss darauf zugegriffen werden: e['day-of-week'] statt Punktnotation.

7
hour

Zwischen 0 und 23.

23
minute

Zwischen 0 und 59.

59
month

Zwischen 1 und 12.

12
second

Zwischen 0 und 59.

59
timezone

Zeitzone

UTC
triggerUid

ID des Triggers, der dieses Ereignis erzeugt hat.

4034124084959907503
week-of-year

Zwischen 1 und 52.

Da dieser Property-Name Bindestriche enthält, muss darauf zugegriffen werden: e['week-of-year'] statt Punktnotation.

52
year

Das Jahr

2015