Class Trigger

Aktywator

Aktywator skryptu.

Metody

Metoda	Zwracany typ	Krótki opis
getEventType()	EventType	Zwraca typ zdarzenia, które uruchamia regułę.
getHandlerFunction()	String	Zwraca funkcję, która zostanie wywołana po zadziałaniu czynnika uruchamiającego.
getTriggerSource()	TriggerSource	Zwraca źródło zdarzeń, które uruchamiają regułę.
getTriggerSourceId()	String	Zwraca identyfikator źródła.
getUniqueId()	String	Zwraca unikalny identyfikator, który umożliwia odróżnianie od siebie poszczególnych wyzwalaczy.

Szczegółowa dokumentacja

getEventType()

Zwraca typ zdarzenia, które uruchamia regułę.

const triggers = ScriptApp.getProjectTriggers();
for (let i = 0; i < triggers.length; i++) {
  if (triggers[i].getEventType() === ScriptApp.EventType.CLOCK) {
    // Some code here - other options are:
    // ScriptApp.EventType.ON_EDIT
    // ScriptApp.EventType.ON_FORM_SUBMIT
    // ScriptApp.EventType.ON_OPEN
  }
}

Powrót

EventType – typ zdarzenia, którego dotyczy ten parametr.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

• https://www.googleapis.com/auth/script.scriptapp

---

getHandlerFunction()

Zwraca funkcję, która zostanie wywołana po zadziałaniu czynnika uruchamiającego.

// Create a trigger for the script.
ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('id of my spreadsheet')
    .onEdit()
    .create();
Logger.log(ScriptApp.getProjectTriggers()[0]
               .getHandlerFunction());  // logs "myFunction"

Powrót

String – nazwa metody

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

• https://www.googleapis.com/auth/script.scriptapp

---

getTriggerSource()

Zwraca źródło zdarzeń, które uruchamiają regułę.

Na przykład reguła na podstawie arkusza kalkulacyjnego, która ma działanie edytuj, zwróci SPREADSHEETS, a reguła na podstawie czasu zwróci CLOCK.

const triggers = ScriptApp.getProjectTriggers();
for (let i = 0; i < triggers.length; i++) {
  if (triggers[i].getTriggerSource() === ScriptApp.TriggerSource.CLOCK) {
    Logger.log(`${triggers[i].getUniqueId()} source is clock`);
  } else if (
      triggers[i].getTriggerSource() === ScriptApp.TriggerSource.SPREADSHEETS) {
    Logger.log(`${triggers[i].getUniqueId()} source is spreadsheets`);
  }
}

Powrót

TriggerSource – wydawca, dla którego jest to reguła

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

• https://www.googleapis.com/auth/script.scriptapp

---

getTriggerSourceId()

Zwraca identyfikator źródła.

Jeśli na przykład źródłem reguły jest arkusz kalkulacyjny, będzie to identyfikator tego arkusza. W przypadku zdarzeń zegara zwraca wartość null.

Powrót

String – identyfikator elementu w usłudze wydawcy, dla którego jest to element wyzwalający

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

• https://www.googleapis.com/auth/script.scriptapp

---

getUniqueId()

Zwraca unikalny identyfikator, który umożliwia odróżnianie od siebie poszczególnych wyzwalaczy.

Powrót

String – unikalny identyfikator reguły

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

• https://www.googleapis.com/auth/script.scriptapp