이 페이지는 Cloud Translation API를 통해 번역되었습니다.

편집기 매니페스트 리소스

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

편집자

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

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

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.com`는 `subdomain.example.com`과 일치합니다. 및 `another.subdomain.example.com`
`pathPrefix`	`string` 선택사항. `hostPattern`의 도메인을 추가하는 경로입니다. 예를 들어 URL 호스트 패턴이 `support.example.com`인 경우 `support.example.com/cases/`에 호스팅된 케이스의 URL과 일치시키려면 `cases`을 사용합니다. 호스트 패턴 도메인의 모든 URL과 일치시키려면 `pathPrefix`을 비워둡니다.

hostPattern

string

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

예를 들어 *.example.com는 subdomain.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`을 사용합니다.