Google Workspace 부가기능 트리거

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Apps Script 트리거는 지정된 이벤트가 발생할 때마다 지정된 스크립트 함수 (트리거 함수)를 실행합니다. 특정 이벤트만 트리거가 발생할 수 있으며 각 Google Workspace 애플리케이션은 서로 다른 이벤트 집합을 지원합니다.

트리거가 실행되면 이벤트 객체가 생성됩니다. 이 JSON 구조에는 발생한 이벤트에 대한 세부정보가 포함됩니다. 이벤트 객체 구조의 정보는 트리거 유형에 따라 다르게 구성됩니다.

이벤트 객체가 생성되면 Apps Script가 이 객체를 트리거 함수에 매개변수로 전달합니다. 트리거 함수는 이벤트에 응답하기에 적절한 작업을 실행하기 위해 직접 구현해야 하는 콜백 함수입니다. 예를 들어 Gmail을 확장하는 Google Workspace 부가기능에서는 사용자가 메시지 스레드를 열 때 새 카드 인터페이스를 생성하는 트리거를 정의할 수 있습니다. 이 경우 문맥 콜백 함수를 구현하여 이벤트 객체에 전달된 데이터를 사용하여 새 UI를 구성하는 카드를 만듭니다.

이 페이지에서는 Google Workspace 부가기능 프로젝트에서 트리거를 사용하는 방법에 관한 가이드라인을 제공합니다.

매니페스트 트리거

편집자 부가기능과 달리 Google Workspace 부가기능은 현재 Apps Script 단순 트리거를 사용할 수 없습니다. 대신 Google Workspace 부가기능용으로 설계된 트리거인 매니페스트 트리거를 사용합니다.

매니페스트 트리거는 Google Workspace 부가기능의 매니페스트에서 완전히 정의됩니다. 매니페스트 트리거의 예는 다음과 같습니다.

  • 부가기능 홈페이지를 구축하고 표시하는 홈페이지 트리거
  • Calendar eventOpen 트리거: 새 카드를 표시하거나 Calendar 이벤트가 열릴 때 다른 작업을 실행합니다.
  • Calendar eventUpdate 트리거: 사용자가 Calendar 이벤트를 수정하고 저장할 때 새 카드를 표시하거나 다른 작업을 실행합니다.
  • Drive onItemsSelected 트리거: 새 카드를 표시하거나 사용자가 Drive에서 하나 이상의 파일 또는 폴더를 선택할 때 다른 작업을 실행하는 트리거.
  • Gmail 편지쓰기 트리거는 사용자가 Gmail 편지쓰기 창에서 부가기능을 열 때 부가기능 카드를 표시합니다.
  • Gmail 컨텍스트 트리거: 사용자가 Gmail 메시지를 열 때 새 카드를 표시하거나 다른 작업을 실행합니다.
  • Editor onFileScopeGranted 트리거는 사용자가 현재 편집자 문서에서 drive.file OAuth 범위에 대한 승인을 부여할 때 새 카드를 표시합니다.

위 목록에서는 홈페이지 트리거만 컨텍스트가 없고 나머지는 문맥 트리거입니다. 매니페스트 트리거 정의에 관한 자세한 내용은 매니페스트를 참고하세요.

Google Workspace 부가기능은 매니페스트 트리거 외에도 Apps Script의 설치 가능한 트리거를 사용할 수 있습니다.

제한사항

매니페스트 트리거는 사용에 제한이 있습니다.

  • 이러한 트리거는 Google Workspace 부가기능 프로젝트에서만 사용되며 다른 애플리케이션에서는 사용되지 않습니다.
  • 해당 코드가 아니라 부가기능 매니페스트에 정의되어 있으므로 Apps Script Script 서비스를 사용하여 이러한 트리거를 만들거나 수정할 수 없습니다.
  • Gmail 문맥 트리거에는 현재 unconditional 기준만 있을 수 있습니다. 즉, 콘텐츠와 관계없이 모든 이메일 메시지에 문맥 트리거가 실행됩니다.
  • 각 부가기능에는 문서당 사용자마다 유형당 하나의 트리거만 있을 수 있습니다.