편집기 내에서 Google Workspace 부가기능 콘텐츠와 동작을 정의하는 데 사용되는 리소스 구성입니다. Google Workspace 부가기능 매니페스트에는 편집기를 확장하는 경우 필수로 표시된 모든 구성요소가 있어야 합니다.
편집 도구
편집기 확장 프로그램의 Google Workspace 부가기능 매니페스트 구성 자세한 내용은 Google Workspace 부가기능으로 편집기 확장하기를 참고하세요.
JSON 표현 |
---|
{ "homepageTrigger": { object (HomepageTrigger) }, "onFileScopeGrantedTrigger": { object (OnFileScopeGrantedTrigger) }, "linkPreviewTriggers": [ { object (LinkPreviewTriggers) } ], "createActionTriggers": [ { object (CreateActionTriggers) } } |
필드 | |
---|---|
homepageTrigger |
이 트리거 함수는 호스트 앱에 부가기능 홈페이지를 만듭니다. 이는
|
onFileScopeGrantedTrigger |
부가기능에 현재 편집기 문서와 관련된 동작이 포함된 경우 필요하며, 사용자가 |
linkPreviewTriggers[] |
링크 미리보기에 필요합니다. Google Docs, Sheets, Slides 파일에서 링크를 미리 보기 위한 트리거 목록입니다. 자세한 내용은 스마트 칩으로 링크 미리보기를 참고하세요. |
createActionTriggers[] |
서드 파티 리소스를 만드는 데 필요합니다. @ 메뉴에서 타사 서비스의 리소스를 만들기 위한 트리거 목록입니다. 자세한 내용은 스마트 칩으로 서드 파티 리소스 만들기를 참고하세요. |
OnFileScopeGrantedTrigger
CardService.newEditorFileScopeActionResponseBuilder()
.requestFileScopeForActiveDocument().build();
를 사용하는 요청 파일 범위 대화상자와 사용자가 drive.file
범위 승인을 부여할 때 실행되는 문맥 트리거의 구성입니다.
JSON 표현 |
---|
{ "runFunction": string } |
필드 | |
---|---|
runFunction |
drive.file 범위가 부여된 경우 실행할 함수의 이름입니다. 지정된 경우 이 함수를 구현하여 부가기능 UI에 표시할
Card 객체의 배열을 빌드하고 반환해야 합니다.
|
LinkPreviewTriggers
사용자가 서드 파티 또는 Google 이외의 서비스의 링크를 Docs, Sheets, Slides 파일에 입력하거나 붙여넣을 때 실행되는 트리거의 구성입니다.
Google Workspace 부가기능에 이 트리거를 설정하려면 스마트 칩으로 링크 미리보기를 참고하세요.
JSON 표현 |
---|
{ "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, "patterns": [ { object(patterns) } ] } |
필드 | |
---|---|
labelText |
Example: Support case 와 같이 사용자에게 링크를 미리 보라는 메시지를 표시하는 스마트 칩 예의 텍스트입니다. 이 텍스트는 정적이며 사용자가 부가기능을 실행하기 전에 표시됩니다.
|
localizedLabelText |
labelText 의 지도입니다. 언어는 ISO 639로 지정하고 국가/지역은 ISO 3166을 하이픈 - 으로 구분해서 지정하세요. 예: en-US
지도의 키에 사용자의 언어가 있으면 사용자에게는 |
patterns[] |
|
runFunction |
https://www.googleapis.com/auth/workspace.linkpreview 범위를 승인할 때 실행할 함수의 이름입니다.
지정된 경우 EDITOR_NAME.matchedUrl.url 를 인수로 포함하는 이벤트 객체를 허용하고 부가기능 UI에 링크 미리보기를 표시하는 단일
Card 객체를 반환하도록 이 함수를 구현해야 합니다.
|
logoUrl |
logoUrl 이 사용됩니다.
|
UriPattern
링크 미리보기를 트리거하는 각 URL 패턴의 구성입니다.
JSON 표현 |
---|
{ "hostPattern": string, "pathPrefix" : string } |
필드 | |
---|---|
hostPattern |
subdomain.example.com 와 같은 특정 하위 도메인의 링크를 미리 보려면 하위 도메인을 포함하세요.
전체 도메인의 링크를 미리 보려면 하위 도메인으로 별표 (* )와 함께 와일드 카드 문자를 지정합니다.
예를 들어 |
pathPrefix |
hostPattern 의 도메인을 추가하는 경로입니다.
예를 들어 URL 호스트 패턴이 호스트 패턴 도메인의 모든 URL과 일치시키려면 |
CreateActionTriggers
사용자가 Google Docs @ 메뉴에서 서드 파티 통합 메뉴 항목을 선택할 때 실행되는 트리거의 구성입니다.
Google Workspace 부가기능에 이 트리거를 설정하려면 스마트 칩으로 서드 파티 리소스 만들기를 참고하세요.
JSON 표현 |
---|
{ "id": string, "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, } |
필드 | |
---|---|
id |
[a-zA-Z0-9-]+. 형식이어야 합니다.
|
labelText |
Create support case ).
|
localizedLabelText |
labelText 의 지도입니다. 언어는 ISO 639로 지정하고 국가/지역은 ISO 3166을 하이픈 - 으로 구분해서 지정하세요. 예: en-US
지도의 키에 사용자의 언어가 있으면 사용자에게는 |
runFunction |
|
logoUrl |
logoUrl 이 사용됩니다.
|