本頁面由 Cloud Translation API 翻譯而成。

可安裝的觸發條件

可安裝的觸發條件就像簡易觸發條件一樣 Apps Script 會在系統發生特定事件時自動執行函式。開啟文件等不過可安裝的觸發條件彈性，比簡單的觸發條件服務需要授權、他們提供多種額外的事件，包括時間 (時鐘) 您也能透過程式輔助方式控制適用於簡易型和可安裝的觸發條件，Apps Script 會傳遞已觸發的函式換包含資訊的事件物件事件發生時的情境資訊

限制

雖然可安裝的觸發條件比簡單的觸發條件更具彈性但必須遵守一些限制：

如果檔案是以唯讀 (檢視或註解) 模式開啟，就不會執行。適用對象獨立指令碼，使用者必須至少要具備才能正常執行
指令碼執行和 API 要求不會導致觸發條件執行。例如：撥號中 FormResponse.submit()敬上不會導致表單的提交觸發條件觸發執行。

注意： 這項限制的例外狀況是 Form.submitGrades()。如果代碼使用 onFormSubmit 觸發條件，並呼叫 Form.submitGrades() 觸發條件 onFormSubmit 條件並造成無限迴圈。為了避免無限迴圈，加入程式碼來檢查成績是否已存在呼叫 submitGrades()。
可安裝觸發條件一律會在建立者的帳戶下執行具體做法是指示 Kubernetes 建立並維護一或多個代表這些 Pod 的物件舉例來說，如果您建立可安裝的開啟觸發條件，該觸發條件就會執行同事開啟文件時 (如果同事具有編輯權限)，但可做為你的帳戶使用也就是說，如果您建立在文件開啟時傳送電子郵件，電子郵件一律會來自帳戶，不一定是開立文件的帳戶。不過你可以為每個帳戶建立可安裝的觸發條件。
特定帳戶無法查看從第二個帳戶安裝的觸發條件，但第一個帳戶還是可以啟用這些觸發條件
可安裝的觸發條件受到 Apps Script 觸發條件影響配額限制。

時間導向觸發條件

時間型觸發條件 (也稱為時鐘觸發條件) 與 Cron 工作。以時間為準的觸發條件指令碼只在特定時間或週期性間隔執行或是每月執行一次的頻率(請注意，加購內容使用時間導向的觸發條件最多一次)。時間可能略有不同。舉例來說，如果您建立週期性 9 點的觸發條件 Apps Script 會選擇上午 9 點到上午 10 點之間的時間，然後時間是每天都固定的 24 小時前就會再次觸發

以下為 Google Chat 應用程式每分鐘都會將訊息張貼到該應用程式所在的每個聊天室：

// Example app for Google Chat that demonstrates app-initiated messages
// by spamming the user every minute.
//
// This app makes use of the Apps Script OAuth2 library at:
//     https://github.com/googlesamples/apps-script-oauth2
//
// Follow the instructions there to add the library to your script.

// When added to a space, we store the space's ID in ScriptProperties.
function onAddToSpace(e) {
  PropertiesService.getScriptProperties()
      .setProperty(e.space.name, '');
  return {
    'text': 'Hi! I\'ll post a message here every minute. ' +
            'Please remove me after testing or I\'ll keep spamming you!'
  };
}

// When removed from a space, we remove the space's ID from ScriptProperties.
function onRemoveFromSpace(e) {
  PropertiesService.getScriptProperties()
      .deleteProperty(e.space.name);
}

// Add a trigger that invokes this function every minute in the
// "Edit > Current Project's Triggers" menu. When it runs, it
// posts in each space the app was added to.
function onTrigger() {
  var spaceIds = PropertiesService.getScriptProperties()
      .getKeys();
  var message = { 'text': 'Hi! It\'s now ' + (new Date()) };
  for (var i = 0; i < spaceIds.length; ++i) {
    postMessage(spaceIds[i], message);
  }
}
var SCOPE = 'https://www.googleapis.com/auth/chat.bot';
// The values below are copied from the JSON file downloaded upon
// service account creation.
// For SERVICE_ACCOUNT_PRIVATE_KEY, remember to include the BEGIN and END lines
// of the private key
var SERVICE_ACCOUNT_PRIVATE_KEY = '...';
var SERVICE_ACCOUNT_EMAIL = 'service-account@project-id.iam.gserviceaccount.com';

// Posts a message into the given space ID via the API, using
// service account authentication.
function postMessage(spaceId, message) {
  var service = OAuth2.createService('chat')
      .setTokenUrl('https://accounts.google.com/o/oauth2/token')
      .setPrivateKey(SERVICE_ACCOUNT_PRIVATE_KEY)
      .setClientId(SERVICE_ACCOUNT_EMAIL)
      .setPropertyStore(PropertiesService.getUserProperties())
      .setScope(SCOPE);
  if (!service.hasAccess()) {
    Logger.log('Authentication error: %s', service.getLastError());
    return;
  }
  var url = 'https://chat.googleapis.com/v1/' + spaceId + '/messages';
  UrlFetchApp.fetch(url, {
    method: 'post',
    headers: { 'Authorization': 'Bearer ' + service.getAccessToken() },
    contentType: 'application/json',
    payload: JSON.stringify(message),
  });
}

以事件為準的觸發條件

可安裝的事件導向觸發條件的概念與簡單的觸發條件例如 onOpen()，但它們可以回應其他事件有差異。

例如 Google 試算表的可安裝的開啟觸發條件只要使用者擁有編輯權限，開啟試算表時就會啟用。就像簡單的 onOpen() 觸發條件一樣不過可安裝的版本呼叫授權。可安裝的版本會透過建立觸發條件的使用者授權執行當其他擁有編輯權限的使用者開啟試算表時。

有多種類型的可安裝觸發條件 Google Workspace 應用程式：

「可安裝」觸發條件會在使用者開啟試算表時執行。有權編輯的文件或表單。
可安裝的編輯觸發條件會在使用者修改試算表。
可安裝的「變更」觸發條件會在使用者修改例如新增工作表或移除。
使用者回應表單時，系統會執行可安裝的表單提交觸發條件。表單提交觸發條件有兩種版本 Google 表單本身如果表單提交到試算表，則為 Google 試算表。
使用者的日曆活動時，執行可安裝的日曆活動觸發條件例如建立、編輯或刪除。

您可以在獨立和繫結的指令碼中使用可安裝的觸發條件。例如：獨立指令碼可透過程式輔助方式，建立可安裝的觸發條件方法是呼叫 TriggerBuilder.forSpreadsheet(key)敬上然後傳送試算表的 ID

手動管理觸發條件

如要在指令碼編輯器中手動建立可安裝的觸發條件，請按照下列步驟操作：步驟如下：

開啟 Apps Script 專案。
按一下左側的「觸發條件」圖示。
點選右下方的「新增觸發條件」。
選取並設定您想建立的觸發條件類型。
按一下 [儲存]。

透過程式輔助方式管理觸發條件

您也可以透過程式碼，以程式輔助的方式建立及刪除觸發條件指令碼服務。首先撥打電話 ScriptApp.newTrigger(functionName)、會傳回 TriggerBuilder。

下例說明如何建立兩個時間導向觸發條件，一個觸發事件每 6 小時啟動一次，並且在每週一上午 9 點 (以時區為準) 啟動您的指令碼設定的目標使用者)。

triggers/triggers.gs

前往 GitHub 查看

/**
 * Creates two time-driven triggers.
 * @see https://developers.google.com/apps-script/guides/triggers/installable#time-driven_triggers
 */
function createTimeDrivenTriggers() {
  // Trigger every 6 hours.
  ScriptApp.newTrigger('myFunction')
      .timeBased()
      .everyHours(6)
      .create();
  // Trigger every Monday at 09:00.
  ScriptApp.newTrigger('myFunction')
      .timeBased()
      .onWeekDay(ScriptApp.WeekDay.MONDAY)
      .atHour(9)
      .create();
}

下一個範例說明如何為試算表。請注意，與簡易 onOpen() 觸發條件不同的是，可安裝的觸發條件不需要與試算表繫結。如要建立這個觸發條件 SpreadsheetApp.getActive()與以下電話號碼的成員通話： SpreadsheetApp.openById(id)。

triggers/triggers.gs

前往 GitHub 查看

/**
 * Creates a trigger for when a spreadsheet opens.
 * @see https://developers.google.com/apps-script/guides/triggers/installable
 */
function createSpreadsheetOpenTrigger() {
  const ss = SpreadsheetApp.getActive();
  ScriptApp.newTrigger('myFunction')
      .forSpreadsheet(ss)
      .onOpen()
      .create();
}

如要透過程式輔助方式修改現有可安裝的觸發條件，您必須將其刪除建立新頻道如果您先前已儲存觸發條件的 ID，將 ID 做為引數傳遞至以下函式以刪除。

triggers/triggers.gs

前往 GitHub 查看

/**
 * Deletes a trigger.
 * @param {string} triggerId The Trigger ID.
 * @see https://developers.google.com/apps-script/guides/triggers/installable
 */
function deleteTrigger(triggerId) {
  // Loop over all triggers.
  const allTriggers = ScriptApp.getProjectTriggers();
  for (let index = 0; index < allTriggers.length; index++) {
    // If the current trigger is the correct one, delete it.
    if (allTriggers[index].getUniqueId() === triggerId) {
      ScriptApp.deleteTrigger(allTriggers[index]);
      break;
    }
  }
}

觸發條件發生錯誤

當可安裝的觸發條件啟動，但函式擲回例外狀況或否則就無法。畢竟，當時間觸發的觸發條件執行，或其他使用者啟用時提交表單觸發條件，您可能根本不在電腦前。

而是會透過電子郵件將下列內容傳送給您：

From: noreply-apps-scripts-notifications@google.com
Subject: Summary of failures for Google Apps Script
Your script has recently failed to finish successfully.
A summary of the failure(s) is shown below.

並在信中提供停用或重新設定觸發條件的連結。如果指令碼為繫結匯出至 Google 試算表、文件或表單檔案，電子郵件中也會附上該檔案的連結。這些連結請停用觸發條件或編輯指令碼來修正錯誤。

如要查看所有與您的 Google 帳戶相關聯的觸發條件，以及停用不再需要的觸發條件，請按照下列步驟操作：

前往 script.google.com。
按一下左側的「我的觸發條件」。
如要刪除觸發條件，請按一下觸發條件右側的「更多」圖示 >刪除觸發條件。

注意： 無法透過這個方式停用 onOpen() 等簡易觸發條件頁面；但必須編輯適當的指令碼，並移除或重新命名 onOpen() 函式。

外掛程式中的觸發條件

除了可安裝的觸發條件外，您也可以在外掛程式。如需更多資訊看 Google Workspace 外掛程式觸發條件。