Gmail 매니페스트 리소스

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

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에서 메일이 열릴 때 실행되는 트리거 목록입니다. 트리거가 실행되면 일반적으로 새 카드를 만들고 UI를 업데이트하는 특정 Apps Script 함수를 실행합니다.
homepageTrigger

object (HomepageTrigger)

Gmail 호스트에서 부가기능 홈페이지를 만드는 트리거 함수 사양입니다. 이렇게 하면 addOns.common.homepageTrigger가 재정의됩니다.

ComposeTrigger

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

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

string

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

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

object (SelectAction)

Compose UI를 만드는 Compose 작업 목록입니다. 단, 이 목록은 부가기능당 하나의 작업으로 제한됩니다. 작성 작업에는 Gmail 작성 창에 표시되는 상응하는 아이콘이 있습니다. 아이콘은 gmail.logoUrl로 지정됩니다.

ContextualTrigger

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

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

string

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

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

unconditional

object

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

SelectAction

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

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

string

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

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

text

string

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