단순 트리거와 마찬가지로 설치 가능한 트리거는 Apps Script는 특정 이벤트, 발생할 수 있습니다. 그러나 설치 가능한 트리거는 더 많은 옵션을 제공합니다. 단순 트리거보다 유연성이 뛰어납니다. 서비스 필요한 승인, 시간 기반 (시계)을 포함하여 몇 가지 추가 이벤트 유형을 제공합니다. 프로그래매틱 방식으로 제어할 수 있습니다. 단순성과 설치 가능한 트리거, Apps Script에서 트리거된 함수 전달 - 정보가 포함된 이벤트 객체 이벤트가 발생한 맥락 정보를 보여줍니다.
제한사항
설치 가능한 트리거가 단순한 트리거보다 더 많은 유연성을 제공하지만, 그러나 여전히 다음과 같은 몇 가지 제한사항이 적용됩니다.
- 파일이 읽기 전용 (보기 또는 댓글 작성) 모드로 열린 경우 실행되지 않습니다. 대상 사용자는 최소한 몇 가지 구성 요소가 필요합니다
스크립트 실행 및 API 요청으로 인해 트리거가 실행되지 않습니다. 예를 들어 통화
FormResponse.submit()드림 를 입력해도 양식의 제출 트리거가 실행되지 않습니다.설치 가능한 트리거는 항상 만든 사람의 계정에서 실행됩니다. 있습니다. 예를 들어 설치 가능한 열기 트리거를 만들면 동료가 문서를 열 때 (동료에게 수정 액세스 권한이 있는 경우) 계정으로 실행됩니다. 즉, 특정 기간 동안만 운영하도록 문서를 열 때 이메일을 보내는 경우, 이메일은 항상 문서를 연 계정이 아닐 수도 있습니다. 하지만 계정마다 설치 가능한 트리거를 만들 수 있습니다. 이렇게 하면 한 번에 하나의 이메일로 전송됩니다.
두 번째 계정에서 설치한 트리거는 볼 수 없습니다. 하지만 첫 번째 계정에서 해당 트리거를 계속 활성화할 수 있습니다.
설치 가능한 트리거에는 Apps Script 트리거가 적용됨 할당량 한도를 관리할 수 있습니다.
시간 기반 트리거
시간 기반 트리거 (시계 트리거라고도 함)는 크론 작업에 사용할 수 있습니다. 시간 기반 트리거를 통해 스크립트가 특정 시간 또는 반복 주기로 1분마다 또는 드물게 한 달에 한 번 (참고: 부가기능 시간 기반 트리거를 사용하여 최대 1시간에 한 번) 시간이 다소 걸릴 수 있음 예를 들어 반복되는 오전 9시 트리거를 만들면 Apps Script에서 오전 9시에서 오전 10시 사이의 시간을 선택한 다음 그 타이밍은 매일 일정하게 유지되도록 24시간이 지날 때까지 실행할 수도 있습니다
다음은 kubectl 명령어 Google Chat 앱 앱이 있는 모든 스페이스에 1분마다 메시지를 게시합니다.
// 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() 트리거와 같습니다. 하지만 설치 가능한 버전은
필요한 서비스에
승인이 필요하지 않습니다. 설치 가능한
트리거가 생성된 사용자의 승인으로 실행되며
수정 권한이 있는 다른 사용자가 스프레드시트를 여는 경우
현재 Kubernetes 클러스터에 Google Workspace 애플리케이션:
- 설치 가능한 열기 트리거는 사용자가 스프레드시트를 열 때 실행됩니다. 문서, 양식 등 수정 권한이 있는 사용자가 필요합니다.
- 설치 가능한 edit 트리거는 사용자가 스프레드시트입니다.
- 설치 가능한 변경 트리거는 사용자가 클러스터의 구조를 수정할 때 실행됩니다. 예를 들어 새 시트를 추가하거나 기존 시트의 를 클릭합니다.
- 설치 가능한 양식 제출 트리거는 사용자가 양식에 응답할 때 실행됩니다. 양식 제출 트리거에는 두 가지 버전이 있습니다. 하나는 Google Forms에 스프레드시트에 대한 하나(양식이 스프레드시트로 제출되는 경우)
- 설치 가능한 캘린더 이벤트 트리거는 사용자의 캘린더 일정이 실행될 때 실행됩니다. 즉, 생성, 수정 또는 삭제됩니다.
독립형 및 바인드된 스크립트에서 설치 가능한 트리거를 사용할 수 있습니다. 예를 들어
독립형 스크립트는 프로그래매틱 방식으로
Google Sheets 파일을
TriggerBuilder.forSpreadsheet(key) 드림
스프레드시트의 ID를 전달하여
수동으로 트리거 관리
스크립트 편집기에서 설치 가능한 트리거를 수동으로 만들려면 다음 안내를 따르세요. 다음 단계를 따르세요.
- Apps Script 프로젝트를 엽니다.
- 왼쪽에서 트리거 를 클릭합니다.
- 오른쪽 하단에서 트리거 추가를 클릭합니다.
- 만들려는 트리거 유형을 선택하고 구성합니다.
- 저장을 클릭합니다.
프로그래매틱 방식으로 트리거 관리
또한 다음 명령어로 트리거를 만들고 삭제할 수도 있습니다.
스크립트 서비스: 다음을 호출하여 시작
ScriptApp.newTrigger(functionName)님,
이 함수는
TriggerBuilder
다음 예는 두 개의 시간 기반 트리거를 만드는 방법을 보여줍니다. 6시간마다, 그리고 매주 월요일 오전 9시에 실행(시간대 (스크립트가 설정된 값)이 있습니다.
다음 예시에서는 트리거에 대한 설치 가능한 열기 트리거를
스프레드시트입니다. 간단한 onOpen() 트리거와 달리
설치 가능한 트리거를 스프레드시트에 결합하지 않아도 됩니다. 만들기
이 트리거를 실행하는 경우
통화 대상 SpreadsheetApp.getActive()
SpreadsheetApp.openById(id)
설치 가능한 기존 트리거를 프로그래매틱 방식으로 수정하려면 삭제해야 합니다. 새로 만듭니다. 이전에 트리거 ID를 저장한 경우 다음 작업을 수행할 수 있습니다. 아래 함수에 ID를 인수로 전달하여 삭제하세요.
트리거 오류
설치 가능한 트리거가 실행되었지만 함수에서 예외가 발생하거나 실행에 실패하면 화면에 오류 메시지가 화면에 나타납니다. 결국 시간 기반 트리거가 실행되거나 다른 사용자가 활성화될 때 양식 제출이 트리거되지 않으면 컴퓨터를 사용하고 있지 않을 수도 있습니다.
대신 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으로 이동합니다.- 왼쪽에서 내 트리거를 클릭합니다.
트리거를 삭제하려면 트리거 오른쪽에서 더보기를 클릭합니다. > 트리거 삭제.
부가기능의 트리거
설치 가능한 트리거 외에도 다음 위치에서 매니페스트 트리거를 사용하여 추가할 수 있습니다. 자세한 내용은 보기 Google Workspace 부가기능 트리거