이 페이지는 Cloud Translation API를 통해 번역되었습니다.

설치 가능한 트리거

단순 트리거와 마찬가지로 설치 가능한 트리거를 사용하면 문서 열기와 같은 특정 이벤트가 발생할 때 Apps Script에서 함수를 자동으로 실행할 수 있습니다. 하지만 설치 가능한 트리거는 단순한 트리거보다 유연성이 높습니다. 즉, 승인이 필요한 서비스를 호출할 수 있고 시간 기반 (시계) 트리거를 비롯한 여러 추가 이벤트 유형을 제공하며, 프로그래매틱 방식으로 제어할 수 있습니다. 단순 트리거와 설치 가능한 트리거 모두 Apps Script는 트리거된 함수에 이벤트가 발생한 컨텍스트에 대한 정보가 포함된 이벤트 객체를 전달합니다.

제한사항

설치 가능한 트리거는 단순 트리거보다 더 높은 유연성을 제공하지만 여전히 몇 가지 제한사항이 적용됩니다.

파일이 읽기 전용 (보기 또는 댓글 작성) 모드로 열린 경우 실행되지 않습니다. 독립형 스크립트의 경우 트리거가 올바르게 실행되려면 사용자에게 최소한 스크립트 파일에 대한 보기 액세스 권한이 필요합니다.
스크립트 실행 및 API 요청으로 인해 트리거가 실행되지 않습니다. 예를 들어 FormResponse.submit()를 호출하여 새 양식 응답을 제출하더라도 양식의 제출 트리거가 실행되지 않습니다.

참고: 이 제한의 예외는 Form.submitGrades()입니다. 코드에서 onFormSubmit 트리거를 사용하는 경우 Form.submitGrades()를 호출하면 onFormSubmit 조건이 트리거되고 무한 루프가 발생합니다. 무한 루프를 방지하려면 submitGrades()를 호출하기 전에 성적이 이미 있는지 확인하는 코드를 추가합니다.
설치 가능한 트리거는 항상 트리거를 만든 사용자의 계정에서 실행됩니다. 예를 들어 설치 가능한 열기 트리거를 만들면 동료가 문서를 열 때 (동료에게 수정 액세스 권한이 있는 경우) 해당 트리거가 실행되지만 내 계정으로 실행됩니다. 즉, 문서가 열릴 때 이메일을 보내는 트리거를 만들면 이메일을 보낸 계정은 항상 내 계정에서 전송되며, 문서를 연 계정이 아닐 수도 있습니다. 그러나 계정마다 설치 가능한 트리거를 만들 수 있으며 이 경우 각 계정에서 하나의 이메일이 전송됩니다.
첫 번째 계정에서 해당 트리거를 계속 활성화할 수 있더라도 지정된 계정은 두 번째 계정에서 설치된 트리거를 볼 수 없습니다.
설치 가능한 트리거에는 Apps Script 트리거 할당량 한도가 적용됩니다.

시간 기반 트리거

시간 기반 트리거 (클록 트리거라고도 함)는 Unix의 크론 작업과 유사합니다. 시간 기반 트리거를 사용하면 스크립트를 특정 시간 또는 반복 간격(1분마다, 월 1회 등)으로 실행할 수 있습니다. (부가기능은 최대 1시간에 한 번 시간 기반 트리거를 사용할 수 있습니다.) 시간은 약간 무작위로 지정될 수 있습니다. 예를 들어 반복되는 오전 9시 트리거를 만들면 Apps Script에서 오전 9시와 오전 10시 사이의 시간을 선택한 다음 이 시간을 매일 일관되게 유지하여 트리거가 다시 실행되기 전에 24시간이 경과할 수 있습니다.

다음은 앱이 있는 모든 스페이스에 1분마다 메시지를 게시하는 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 Sheets의 설치 가능한 열기 트리거는 간단한 onOpen() 트리거와 마찬가지로 수정 액세스 권한이 있는 사용자가 스프레드시트를 열 때마다 활성화됩니다. 그러나 설치 가능한 버전은 승인이 필요한 서비스를 호출할 수 있습니다. 설치 가능한 버전은 트리거를 만든 사용자의 승인으로 실행됩니다. 수정 액세스 권한이 있는 다른 사용자가 스프레드시트를 여는 경우에도 마찬가지입니다.

Google Workspace 애플리케이션에는 다음과 같이 설치 가능한 여러 트리거가 있습니다.

설치 가능한 열기 트리거는 사용자가 수정 권한이 있는 스프레드시트, 문서 또는 양식을 열 때 실행됩니다.
설치 가능한 edit 트리거는 사용자가 스프레드시트에서 값을 수정할 때 실행됩니다.
설치 가능한 변경 트리거는 사용자가 새 시트 추가 또는 열 삭제와 같이 스프레드시트 자체의 구조를 수정할 때 실행됩니다.
설치 가능한 양식 제출 트리거는 사용자가 양식에 응답할 때 실행됩니다. 양식 제출 트리거에는 두 가지 버전이 있습니다. Google Forms 자체용 트리거와 양식이 스프레드시트에 제출되는 경우 Sheets용 트리거입니다.
설치 가능한 캘린더 이벤트 트리거는 사용자의 캘린더 일정이 업데이트(생성, 수정 또는 삭제)될 때 실행됩니다.

독립형 및 바인드된 스크립트에서 설치 가능한 트리거를 사용할 수 있습니다. 예를 들어 독립형 스크립트는 TriggerBuilder.forSpreadsheet(key)를 호출하고 스프레드시트의 ID를 전달하여 임의의 Google Sheets 파일을 위한 설치 가능한 트리거를 프로그래매틱 방식으로 만들 수 있습니다.

수동으로 트리거 관리

스크립트 편집기에서 설치 가능한 트리거를 수동으로 만들려면 다음 단계를 따르세요.

Apps Script 프로젝트를 엽니다.
왼쪽에서 트리거 를 클릭합니다.
오른쪽 하단에서 트리거 추가를 클릭합니다.
만들려는 트리거 유형을 선택하고 구성합니다.
저장을 클릭합니다.

프로그래매틱 방식으로 트리거 관리

스크립트 서비스를 사용하여 프로그래매틱 방식으로 트리거를 만들고 삭제할 수도 있습니다. TriggerBuilder를 반환하는 ScriptApp.newTrigger(functionName)를 호출하여 시작합니다.

다음 예는 시간 기반 트리거 두 개, 즉 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;
    }
  }
}

트리거 오류

설치 가능한 트리거가 실행되지만 함수에서 예외가 발생하거나 다른 방법으로 성공적으로 실행되지 않으면 화면에 오류 메시지가 표시되지 않습니다. 결국 시간 기반 트리거가 실행되거나 다른 사용자가 양식 제출 트리거를 활성화할 때는 컴퓨터를 사용할 수조차 없을 수도 있습니다.

대신 Apps Script에서 다음과 같은 이메일을 보냅니다.

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 Sheets, Docs, Forms 파일에 바인딩된 경우 이메일에도 해당 파일의 링크가 포함됩니다. 이 링크를 통해 트리거를 비활성화하거나 스크립트를 수정하여 버그를 수정할 수 있습니다.

Google 계정과 연결된 모든 트리거를 검토하고 더 이상 필요하지 않은 트리거를 비활성화하려면 다음 단계를 따르세요.

script.google.com으로 이동합니다.
왼쪽에서 내 트리거를 클릭합니다.
트리거를 삭제하려면 트리거 오른쪽에서 더보기 > 트리거 삭제를 클릭합니다.

참고: onOpen()와 같은 간단한 트리거는 이 페이지에서 비활성화할 수 없습니다. 대신 적절한 스크립트를 수정하고 onOpen() 함수를 삭제하거나 이름을 변경해야 합니다.

부가기능의 트리거

설치 가능한 트리거 외에도 부가기능에서 매니페스트 트리거를 사용할 수 있습니다. 자세한 내용은 Google Workspace 부가기능 트리거를 참고하세요.