편집기 매니페스트 리소스

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

편집자

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

JSON 표현 
  {
    "homepageTrigger": {
      object (HomepageTrigger)
    },
    "onFileScopeGrantedTrigger": {
      object (OnFileScopeGrantedTrigger)
    },
    "linkPreviewTriggers": [
      {
        object (LinkPreviewTriggers)
      }
    ],
    "createActionTriggers": [
      {
        object (CreateActionTriggers)
      }
  }
필드
homepageTrigger

object (HomepageTrigger)

이 트리거 함수는 호스트 앱에 부가기능 홈페이지를 만듭니다. 이는 addOns.common.homepageTrigger를 재정의합니다.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

사용자가 drive.file 범위를 승인할 때 트리거되며, 부가기능에 현재 문서와 관련된 동작이 포함된 경우 필요합니다.
linkPreviewTriggers[]

object (LinkPreviewTriggers)

링크 미리보기에 필요합니다. Google Docs, Sheets 또는 Slides 파일에서 링크를 미리 볼 수 있는 트리거 목록입니다. 자세한 내용은 스마트 칩을 사용한 미리보기 링크를 참고하세요.

createActionTriggers[]

object (createActionTriggers)

서드 파티 리소스 생성에 필요합니다. @ 메뉴에서 서드 파티 서비스에 리소스를 만들기 위한 트리거 목록입니다. 자세한 내용은 스마트 칩으로 서드 파티 리소스 만들기를 참고하세요.

OnFileScopeGrantedTrigger

요청 파일 범위 대화상자에서 CardService.newEditorFileScopeActionResponseBuilder().requestFileScopeForActiveDocument().build();를 사용하고 사용자가 drive.file 범위 승인을 부여할 때 트리거되는 컨텍스트 트리거의 구성입니다.

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

string

drive.file 범위가 부여된 경우 실행할 함수의 이름입니다. 이 함수는 UI에 사용할 Card 객체의 배열을 반환해야 합니다.

LinkPreviewTriggers

사용자가 서드 파티 서비스의 링크를 Docs, Sheets 또는 Slides 파일에 입력하거나 붙여넣을 때 트리거되는 트리거의 구성입니다.

Google Workspace 부가기능에 이 트리거를 설정하려면 스마트 칩을 사용한 미리보기 링크를 참고하세요.

JSON 표현 
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
필드
labelText

string

필수사항. 사용자에게 링크를 미리 보도록 안내하는 예시 스마트 칩의 텍스트입니다(예: Example: Support case). 이 텍스트는 정적입니다.
localizedLabelText

map (key: string, value: string)

선택사항입니다. 다른 언어로 현지화할 labelText 지도입니다. 언어는 ISO 639로, 국가/지역은 ISO 3166으로 지정하고 하이픈 -으로 구분합니다.
patterns[]

object (UriPattern)

필수사항. 링크를 미리 보기 위해 부가기능을 트리거하는 URL 패턴의 배열입니다.
runFunction

string

필수사항. 사용자가 https://www.googleapis.com/auth/workspace.linkpreview 범위를 승인할 때 실행할 함수의 이름입니다. 이 함수는 미리 볼 URL이 포함된 matchedUrl.url 속성을 포함하는 이벤트 객체를 허용하고 Card 객체를 반환해야 합니다.
logoUrl

string

선택사항입니다. 스마트 칩과 미리보기 카드에 표시되는 아이콘입니다. 생략하면 부가기능은 툴바 아이콘 logoUrl을 사용합니다.

UriPattern

링크 미리보기를 트리거하는 각 URL 패턴의 구성입니다.

JSON 표현 
{
  "hostPattern": string,
  "pathPrefix" : string
}
필드
hostPattern

string

각 URL 패턴에 필요합니다. URL 패턴 도메인입니다. 이 도메인이 포함된 링크를 애드온에서 미리 봅니다. 모든 하위 도메인을 일치시키려면 와일드 카드 별표 (*)를 사용합니다.
pathPrefix

string

선택사항입니다. 도메인에 추가되는 경로입니다. 도메인의 모든 URL과 일치시키려면 pathPrefix를 비워둡니다.

CreateActionTriggers

사용자가 Google Docs @ 메뉴에서 서드 파티 통합 메뉴 항목을 선택할 때 실행되는 트리거의 구성입니다.

Google Workspace 부가기능에 이 트리거를 설정하려면 스마트 칩으로 서드 파티 리소스 만들기를 참고하세요.

JSON 표현 
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
필드
id

string

필수사항. 이 확장 프로그램 포인트의 고유 ID입니다. [a-zA-Z0-9-]+. 형식으로 최대 64자(영문 기준)까지 사용합니다.
labelText

string

필수사항. @ 메뉴에 표시되는 텍스트입니다(예: Create support case).
localizedLabelText

map (key: string, value: string)

선택사항입니다. 현지화할 labelText 지도 언어는 ISO 639로, 국가/지역은 ISO 3166으로 형식을 지정하고 하이픈 -으로 구분합니다.
runFunction

string

필수사항. 사용자가 확장 프로그램 포인트를 선택할 때 실행할 함수의 이름입니다. 함수는 양식 카드를 반환해야 합니다.
logoUrl

string

선택사항입니다. @ 메뉴에 표시되는 아이콘입니다. 생략하면 부가기능은 툴바 아이콘 logoUrl을 사용합니다.