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 UI 확장을 참고하세요.

contextualTriggers[]

object (ContextualTrigger)

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

object (HomepageTrigger)

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

ComposeTrigger

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

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

string

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

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

object (SelectAction)

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

ContextualTrigger

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

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

string

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

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

unconditional

object

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

SelectAction

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

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

string

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

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

text

string

작성 작업에 필요합니다. 이 작성 작업에 관한 짧은 텍스트 설명입니다.