Package google.apps.script.type.gmail

색인

ComposeTrigger

사용자가 이메일을 작성할 때 활성화되는 트리거.

필드
actions[]

MenuItemExtensionPoint

작성 시간 부가기능의 작업 집합을 정의합니다. 사용자가 작성 시간 부가기능에서 트리거할 수 있는 작업입니다.

draftAccess

DraftAccess

작성 시간 부가기능이 트리거될 때의 데이터 액세스 수준을 정의합니다.

초안 액세스

작성 트리거에 필요한 데이터 액세스 수준을 정의하는 enum입니다.

열거형
UNSPECIFIED draftAccess에 아무것도 설정되지 않은 경우 기본값입니다.
NONE Compose 부가기능이 트리거되면 작성 트리거는 초안의 데이터에 액세스할 수 없습니다.
METADATA Compose 부가기능이 트리거될 때 초안 메타데이터에 액세스할 수 있는 권한을 Compose 트리거에 부여합니다. 임시보관 메일의 받는사람 및 참조 목록과 같은 잠재고객 목록이 포함됩니다.

컨텍스트 트리거

열린 이메일이 특정 기준을 충족할 때 실행되는 트리거를 정의합니다. 트리거가 실행되면 일반적으로 새 카드를 만들고 UI를 업데이트하기 위해 특정 엔드포인트를 실행합니다.

필드
onTriggerFunction

string

필수 항목입니다. 메시지가 트리거와 일치할 때 호출할 엔드포인트의 이름입니다.

통합 필드 trigger는 트리거 유형에 따라 Gmail에서 부가기능을 표시하는 데 사용하는 조건이 결정됩니다. trigger은 다음 중 하나여야 합니다.
unconditional

UnconditionalTrigger

무조건 트리거는 메일 메시지가 열릴 때 실행됩니다.

GmailAddOnManifest

Gmail 부가기능의 디자인 및 실행을 맞춤설정하는 속성입니다.

필드
homepageTrigger

HomepageExtensionPoint

선언된 문맥 트리거와 일치하지 않는 컨텍스트에서 실행될 엔드포인트를 정의합니다. 이 함수로 생성된 카드는 항상 사용자에게 제공되지만 이 부가기능이 타겟팅된 트리거를 더 많이 선언하면 상황별 콘텐츠에서 삭제될 수 있습니다.

있는 경우 addOns.common.homepageTrigger의 구성을 재정의합니다.

contextualTriggers[]

ContextualTrigger

부가기능을 트리거하는 조건 집합을 정의합니다.

universalActions[]

UniversalAction

부가기능의 범용 작업 집합을 정의합니다. 사용자가 부가기능 툴바 메뉴에서 범용 작업을 트리거합니다.

composeTrigger

ComposeTrigger

편지쓰기 시간 부가기능의 편지쓰기 시간 트리거를 정의합니다. 이는 사용자가 이메일을 작성할 때 부가기능이 작업을 실행하는 트리거입니다. 모든 편지쓰기 시간 부가기능에는 초안을 수정할 수 없더라도 gmail.addons.current.action.compose 범위가 있어야 합니다.

authorizationCheckFunction

string

서드 파티 API를 프로브하여 부가기능에 모든 필수 서드 파티 승인이 있는지 확인하는 엔드포인트의 이름. 프로브가 실패하면 함수에서 예외를 발생시켜 승인 흐름을 시작합니다. 이 함수는 원활한 사용자 환경을 보장하기 위해 각 부가기능 호출 전에 호출됩니다.

UnconditionalTrigger

이메일 메시지가 열릴 때 실행되는 트리거입니다.

유니버설 액션

메시지 컨텍스트와 관계없이 항상 부가기능 툴바 메뉴에서 사용할 수 있는 작업입니다.

필드
text

string

필수 항목입니다. 작업을 설명하는 사용자에게 표시되는 텍스트(예: '새 연락처 추가')

통합 필드 action_type는 작업 유형에 따라 사용자가 작업을 호출할 때 Gmail의 동작이 결정됩니다. action_type은 다음 중 하나여야 합니다.
runFunction

string

사용자가 작업을 트리거할 때 호출되는 엔드포인트입니다. 자세한 내용은 범용 작업 가이드를 참고하세요.