Class Trigger

Aktywator

Aktywator skryptu.

Metody

MetodaZwracany typKrótki opis
getEventType()EventTypeZwraca typ zdarzenia, które uruchamia regułę.
getHandlerFunction()StringZwraca funkcję, która zostanie wywołana po zadziałaniu czynnika uruchamiającego.
getTriggerSource()TriggerSourceZwraca źródło zdarzeń, które uruchamiają regułę.
getTriggerSourceId()StringZwraca identyfikator źródła.
getUniqueId()StringZwraca 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