Apps Script 트리거가 지정된 스크립트를 발생시킵니다. 지정된 이벤트가 발생할 때마다 실행할 함수 (트리거 함수) 발생합니다 특정 이벤트만 트리거를 실행할 수 있으며 각 이벤트마다 Google Workspace 애플리케이션은 다양한 이벤트를 지원합니다.
트리거가 실행되면 이벤트 객체가 생성됩니다. 이 JSON 구조 발생한 이벤트에 대한 세부정보가 포함됩니다. 이벤트의 정보입니다. 객체 구조는 트리거 유형에 따라 다르게 구성됩니다.
이벤트 객체가 생성되면 Apps Script에서 이 객체를 매개변수로 트리거 함수입니다. 트리거 함수는 콜백 함수로 적절한 조치를 취할 수 있도록 이벤트를 처리합니다. 예를 들어 Gmail을 확장하는 Google Workspace 부가기능은 사용자가 메시지를 열 때 새 카드 인터페이스를 생성하는 트리거 정의 있습니다. 이 경우 상황별 콜백 함수를 구현하여 새 UI를 구성하는 카드는 이벤트 객체입니다.
이 페이지에서는 Google Workspace 살펴보겠습니다
매니페스트 트리거
편집자 부가기능과 달리 Google Workspace 부가기능은 현재 Apps Script 단순 트리거를 사용할 수 없습니다. 대신 이러한 유형의 제품 또는 서비스를 위해 특별히 설계된 Google Workspace 부가기능: 매니페스트 트리거
매니페스트 트리거는 Google Workspace 부가기능 매니페스트). 매니페스트 트리거의 예로는 있습니다.
- 부가기능 홈페이지를 빌드하고 표시하는 홈페이지 트리거입니다.
- Calendar eventOpen 트리거는 새 카드를 표시하거나 다른 작업을 수행할 수 없습니다.
- Calendar eventUpdate 트리거는 새 카드를 표시하거나 사용자가 Calendar 일정을 수정하고 저장할 때의 기타 작업
- 새 카드를 표시하거나 사용자가 드라이브에서 하나 이상의 파일이나 폴더를 선택할 때 다른 작업을 수행할 수 없습니다.
- Gmail 편지쓰기 트리거는 사용자가 Gmail 편지쓰기 창에서 부가기능을 엽니다.
- Gmail 문맥 트리거: 새 카드를 표시하거나 다른 사용자가 Gmail 메일을 열 때 실행되는 작업
- 사용자가 새 카드를 표시할 때 편집자 onFileScopeGranted 트리거가 사용됩니다.
현재 편집기의
drive.fileOAuth 범위에 대한 승인 부여 문서를 참조하세요.
위 목록에서 홈페이지 트리거만 비맥락입니다. 나머지는 상황별 트리거입니다. 매니페스트를 참고하세요. 를 참조하세요.
매니페스트 트리거 외에도 Google Workspace는 부가기능은 Apps Script를 사용하여 설치 가능한 트리거를 사용합니다.
제한사항
매니페스트 트리거는 사용에 특정 제한사항이 있습니다.
- 이러한 트리거는 Google Workspace 부가기능 프로젝트에서만 사용됩니다. 다른 애플리케이션에서는 아무런 의미가 없습니다.
- 이들은 코드가 아니라 부가기능 매니페스트에 정의되어 있으므로 다음 작업을 할 수 없습니다.
Apps Script 사용
Script사용하여 이러한 트리거를 만들거나 수정할 수 있습니다. - Gmail 문맥 트리거에는 현재
unconditional기준만 포함될 수 있습니다. 즉, 네트워크 연결 여부와 관계없이 모든 이메일 메시지에 있습니다. - 각 부가기능에는 사용자 및 문서별로 유형별 트리거가 하나만 있을 수 있습니다.