Gmail 매니페스트 리소스

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

Gmail 내에서 Google Workspace 부가기능 콘텐츠와 동작을 정의하는 데 사용되는 리소스 구성입니다. Google Workspace 부가 매니페스트는 Gmail을 확장하는 경우 모든 구성요소를 필수로 표시해야 합니다.

Gmail

Gmail 확장 프로그램의 Google Workspace 부가기능 매니페스트 구성 자세한 내용은 부가기능 Google Workspace 으로 Gmail 확장하기를 참조하세요.

JSON 표현
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
필드
authorizationCheckFunction

string

지원 중단되었습니다. 타사 승인 요구사항 확인을 수행하는 Apps Script 함수의 이름입니다. 이 함수는 Google Workspace 부가기능이 호출될 때마다 호출됩니다.

불필요한 실행 지연 시간을 피하기 위해 이 함수는 지원 중단되었습니다. 대신 이 예와 같이 부가기능이 기본 호출에서 예외를 발생시켜야 합니다.

composeTrigger

object (ComposeTrigger)

편지쓰기 작업에 필요합니다. 이메일을 작성하는 동안 사용자가 사용할 수 있는 UI 집합을 정의합니다.

자세한 내용은 Compose 작업으로 Compose UI 확장을 참고하세요.

contextualTriggers[]

object (ContextualTrigger)

필수사항. Gmail에서 메시지가 열릴 때 실행되는 트리거 목록 트리거가 실행되면 일반적으로 특정 Apps Script 함수를 실행하여 새 카드를 만들고 UI를 업데이트합니다.
homepageTrigger

object (HomepageTrigger)

Gmail 호스트에서 부가기능 홈페이지를 만들기 위한 트리거 함수 사양입니다. 이는 addOns.common.homepageTrigger을 재정의합니다.

Compose트리거

Compose 작업의 구성입니다. 자세한 내용은 Compose UI 확장을 참고하세요.

JSON 표현
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
필드
draftAccess

string

Compose 트리거 함수에서 사용할 수 있는 데이터 액세스 수준을 정의합니다. 유효한 옵션은 다음과 같습니다.

  • NONE: 기본 설정입니다. 따라서 작성 트리거 함수에 전달된 이벤트 객체는 대부분 비어 있습니다.
  • METADATA: 메시지 트리거 목록에 전달된 이벤트 객체를 메시지의 수신자 목록으로 채웁니다. 이 설정을 사용하려면 부가기능에 gmail.addons.current.message.metadata 범위를 포함해야 합니다.
selectActions[]

object (SelectAction)

Compose UI를 만드는 Compose 작업 목록입니다. 그러나 이 목록은 부가기능당 단일 작업으로 제한됩니다. 작성 작업에는 Gmail 편지쓰기 창에 표시되는 관련 아이콘이 있습니다. 아이콘은 gmail.logoUrl로 지정합니다.

문맥 트리거

사용자가 Gmail 메시지를 열고 이 메시지가 특정 기준을 충족할 때 실행되는 트리거의 구성입니다. 자세한 내용은 메시지 UI 확장을 참조하세요.

JSON 표현
{
  "onTriggerFunction": string,
  "unconditional": {},
}
필드
onTriggerFunction

string

각 문맥 트리거에 필요합니다. 트리거가 실행될 때 실행되는 Apps Script 함수의 이름입니다.

이 함수를 정의하는 방법에 관한 자세한 내용은 컨텍스트 트리거 함수를 참고하세요.

unconditional

object

각 문맥 트리거에 필요합니다. 모든 Gmail 메시지가 표시될 때 문맥 트리거가 활성화되도록 지정하는 데 사용됩니다. 이는 유일한 옵션이므로 항상 빈 객체여야 합니다.

작업 선택

사용자가 작성 작업을 선택할 때 실행할 함수를 정의하는 Compose 작업 구성입니다.

JSON 표현
{
  "runFunction": string,
  "text": string
}
필드
runFunction

string

편지쓰기 작업에 필요합니다. 이 작성 작업을 선택할 때 실행되는 Apps Script 함수의 이름입니다. 이 Compose 트리거 함수는 부가기능 Compose UI를 빌드합니다.

자세한 내용은 Compose 트리거 함수를 참고하세요.

text

string

편지쓰기 작업에 필요합니다. 이 작성 작업에 관한 간단한 텍스트 설명입니다.