편집기 매니페스트 리소스

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

편집기 내에서 부가기능 콘텐츠 및 동작을 정의하는 데 사용되는 리소스 구성입니다. 부가기능 매니페스트에서는 에디터를 확장한다면 필수로 표시된 모든 구성요소를 보유해야 합니다.

편집 도구

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

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

object (HomepageTrigger)

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

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

부가기능에 현재 편집기 문서와 관련된 동작이 포함되어 있고 사용자가 drive.file 범위를 승인할 때 트리거됩니다.

linkPreviewTriggers

object (LinkPreviewTriggers)

링크 미리보기에 필요합니다. 타사 또는 Google 이외의 서비스 콘텐츠를 미리 볼 수 있는 URL 패턴을 정의합니다. 자세한 내용은 Google Docs (개발자 미리보기)에서 링크 미리보기를 참고하세요.

OnFileScopeGrantedTrigger

부가기능이 CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build();를 사용하여 요청 파일 범위 대화상자를 표시하고 사용자가 drive.file 범위 승인을 부여할 때 실행되는 컨텍스트 트리거의 구성.

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

string

drive.file 범위가 부여된 경우 실행할 함수의 이름입니다. 지정된 경우 부가기능 UI에 표시할 Card 객체의 배열을 빌드하고 반환하려면 이 함수를 구현해야 합니다.

LinkPreviewTriggers

사용자가 타사 또는 Google 이외의 서비스에서 링크를 입력하거나 Google Docs 문서에 붙여넣을 때 실행되는 트리거의 구성입니다.

Google Workspace 부가기능에 이 트리거를 설정하려면 Google Docs에서 링크 미리보기 (개발자 미리보기)를 참고하세요.

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

string

필수. Example: Support case와 같이 사용자에게 링크를 미리보기하라는 메시지를 표시하는 스마트 칩의 예시 텍스트 이 텍스트는 정적이며 사용자가 부가기능을 실행하기 전에 표시됩니다.
localizedLabelText

map

필요한 경우 다른 언어로 현지화된 labelText입니다. 언어 및 국가/지역 식별자를 ISO 639 언어 코드-ISO 3166 국가/지역 코드 형식으로 지정합니다. en-US을 예로 들 수 있습니다.
runFunction

string

사용자가 https://www.googleapis.com/auth/documents.readonly 범위를 승인할 때 실행할 함수 이름입니다. 지정된 경우 docs.matchedUrl.url을 포함하는 이벤트 객체를 인수로 허용하고 부가기능 UI에서 링크 미리보기를 표시하는 단일 Card 객체를 반환하도록 이 함수를 구현해야 합니다.
icon

string

스마트 칩에 표시되는 아이콘입니다. 생략하면 칩에서 부가기능의 툴바 아이콘(logoUrl)을 사용합니다.
patterns

object (Patterns)

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

패턴

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

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

string

미리보기할 각 URL 패턴에 필요합니다. URL 패턴의 도메인입니다. 부가기능 미리보기가 이 도메인에 연결됩니다. subdomain.example.com과 같은 특정 하위 도메인의 링크를 미리 보려면 하위 도메인을 포함하세요. 전체 도메인의 링크를 미리 보려면 별표 (*)를 하위 도메인으로 사용하여 와일드 카드 문자를 지정하세요.

예를 들어 *.example.comsubdomain.example.comanother.subdomain.example.com와 일치합니다.

pathPrefix

string

필요한 경우 hostPattern의 도메인을 추가하는 경로입니다.

예를 들어 URL 호스트 패턴이 support.example.com이면 support.example.com/cases/에서 호스팅되는 케이스의 URL과 일치하도록 cases를 입력합니다.

호스트 패턴 도메인의 모든 URL과 일치시키려면 pathPrefix를 비워 둡니다.