Class Trigger

Aktywator

aktywator skryptu;

Metody

MetodaZwracany typKrótki opis
getEventType()EventTypeZwraca typ zdarzenia, które uruchamia regułę.
getHandlerFunction()StringZwraca funkcję, która jest wywoływana po uruchomieniu reguły.
getTriggerSource()TriggerSourceZwraca źródło zdarzeń, które powoduje uruchomienie reguły.
getTriggerSourceId()StringZwraca identyfikator specyficzny dla źródła.
getUniqueId()StringZwraca unikalny identyfikator, który umożliwia odróżnianie od siebie 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, dla którego jest to aktywator.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getHandlerFunction()

Zwraca funkcję, która jest wywoływana po uruchomieniu reguły.

// 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getTriggerSource()

Zwraca źródło zdarzeń, które powoduje uruchomienie reguły.

Na przykład reguła onEdit w arkuszu kalkulacyjnym zwraca SPREADSHEETS, a reguła oparta na czasie zwraca 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getTriggerSourceId()

Zwraca identyfikator specyficzny dla źródła.

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

Powrót

String – identyfikator elementu u wydawcy, dla którego jest to wyzwalacz.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getUniqueId()

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

Powrót

String – unikalny identyfikator wywołania.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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