편집기 매니페스트 리소스

서비스 계정을 정의하는 데 사용되는 Google Workspace 부가기능 콘텐츠와 동작을 변경할 수 있습니다. Google Workspace 부가기능 매니페스트에는 다음 사항이 포함되어야 합니다. 편집기를 확장하면 필수로 표시된 모든 구성요소가 포함됩니다.

편집자

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

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

object (HomepageTrigger)

이 트리거 함수는 부가기능을 생성합니다. homepage의 호스트 앱 이는 다음을 재정의합니다. <ph type="x-smartling-placeholder"></ph> 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

사용자가 링크를 입력하거나 붙여넣을 때 실행되는 트리거의 구성입니다. 서드 파티 또는 Google이 아닌 서비스에서 문서로 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, 하이픈 -으로 구분됩니다. 예: en-US

사용자의 언어가 지도의 키에 있는 경우 사용자에게 현지화된 버전의 labelText입니다.

patterns[]

object (UriPattern)

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

string

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

string

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

UriPattern

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

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

string

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

예를 들어 *.example.comsubdomain.example.com과 일치합니다. 및 another.subdomain.example.com

pathPrefix

string

선택사항입니다. hostPattern의 도메인을 추가하는 경로입니다.

예를 들어 URL 호스트 패턴이 support.example.com인 경우 support.example.com/cases/에 호스팅된 케이스의 URL과 일치시키려면 cases를 사용합니다.

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

CreateActionTriggers

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

Google Workspace 부가기능에 대해 이 트리거를 설정하려면 다음 단계를 따르세요. 보기 스마트 칩으로 서드 파티 리소스 만들기

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

string

필수사항. 이 광고 확장을 구별하기 위한 고유 ID입니다. 있습니다. ID는 최대 64자(영문 기준)까지 입력할 수 있으며 [a-zA-Z0-9-]+.
labelText

string

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

map (key: string, value: string)

선택사항입니다. 다른 언어로 현지화하는 labelText 맵입니다. 언어 형식 지정 국가/지역: ISO 639 ISO 3166, 하이픈 -으로 구분됩니다. 예: en-US

사용자의 언어가 지도의 키에 있는 경우 사용자에게 현지화된 버전의 labelText입니다.

runFunction

string

필수사항. 사용자가 @ 메뉴에서 확장 지점을 선택할 때 실행할 함수의 이름입니다. 함수는 서드 파티 리소스를 만들기 위한 입력이 포함된 양식 카드를 반환해야 합니다.
logoUrl

string

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