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

편집기 매니페스트 리소스

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

편집 도구

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

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

필드

필드
`homepageTrigger`	`object (HomepageTrigger)` 이 트리거 함수는 호스트 앱에 부가기능 홈페이지를 만듭니다. 이는 `addOns.common.homepageTrigger`를 재정의합니다.
`onFileScopeGrantedTrigger`	`object (OnFileScopeGrantedTrigger)` 부가기능에 현재 편집기 문서와 관련된 동작이 포함되어 있고 사용자가 `drive.file` 범위를 승인할 때 트리거됩니다.
`linkPreviewTriggers[]`	개발자 프리뷰: 현재 특정 기능을 사전 체험해 볼 수 있는 Google Workspace 개발자 프리뷰 프로그램의 일환으로 사용자 계정으로 인증할 수 있습니다. `object (LinkPreviewTriggers)` 링크 미리보기에 필요합니다. Google Docs 문서의 링크를 미리 볼 수 있는 트리거 목록입니다. 자세한 내용은 Google Docs (개발자 미리보기)에서 링크 미리보기를 참고하세요.

homepageTrigger

object (HomepageTrigger)

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

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

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

linkPreviewTriggers[]

object (LinkPreviewTriggers)

링크 미리보기에 필요합니다. Google Docs 문서의 링크를 미리 볼 수 있는 트리거 목록입니다. 자세한 내용은 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, "logoUrl": string, "patterns": [ { object(patterns) } ] }

필드
`labelText`	`string` 필수. `Example: Support case`와 같이 사용자에게 링크를 미리보기하라는 메시지를 표시하는 스마트 칩의 예시 텍스트 이 텍스트는 정적이며 사용자가 부가기능을 실행하기 전에 표시됩니다.
`localizedLabelText`	`map` 선택사항입니다. 다른 언어로 현지화하기 위한 `labelText`의 지도 ISO 639로, ISO 3166에서 국가/지역의 형식을 하이픈 `-`으로 구분하여 지정합니다. 예: `en-US` 사용자의 언어가 지도 키에 있으면 현지화된 버전의 `labelText`가 표시됩니다.
`patterns[]`	`object (UriPattern)` 필수. 링크 미리보기의 부가기능을 트리거하는 URL 패턴의 배열입니다.
`runFunction`	`string` 필수. 사용자가 `https://www.googleapis.com/auth/documents.readonly` 범위를 승인할 때 실행할 함수 이름입니다. 경고: 향후 `documents.readonly` 범위는 서드 파티 링크 미리보기의 민감하지 않은 범위로 대체됩니다. 새 범위는 전체 문서가 아닌 URL에 액세스하도록 부가기능을 제한합니다. 부가기능에 링크 미리보기를 계속 사용하려면 새 범위를 사용할 수 있을 때 범위를 업데이트해야 합니다. 지정된 경우 `docs.matchedUrl.url`을 포함하는 이벤트 객체를 인수로 허용하고 부가기능 UI에서 링크 미리보기를 표시하는 단일 `Card` 객체를 반환하도록 이 함수를 구현해야 합니다.
`logoUrl`	`string` 선택사항입니다. 스마트 칩에 표시되는 아이콘입니다. 생략하면 칩에서 부가기능의 툴바 아이콘 `logoUrl`을 사용합니다.

우리패턴

링크 미리보기를 트리거하는 각 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를 비워 둡니다.