A configuração de recursos usada para definir o conteúdo e o comportamento dos complementos do Google Workspace nos editores. Todos os componentes precisam estar marcados como Obrigatórios nos manifestos de complementos do Google Workspace se eles estenderem o Editor.
Editores
Configuração do manifesto de complementos do Google Workspace para extensões do Editor. Consulte Como estender editores com complementos do Google Workspace para mais informações.
Representação JSON |
---|
{ "homepageTrigger": { object (HomepageTrigger) }, "onFileScopeGrantedTrigger": { object (OnFileScopeGrantedTrigger) }, "linkPreviewTriggers": [ { object (LinkPreviewTriggers) } ], "createActionTriggers": [ { object (CreateActionTriggers) } } |
Campos | |
---|---|
homepageTrigger |
Essa função de gatilho cria a
página inicial do complemento no
app host. Isso substitui
|
onFileScopeGrantedTrigger |
Obrigatório se o complemento incluir um comportamento específico para o documento
do Editor atual, acionado quando o usuário autorizar o escopo |
linkPreviewTriggers[] |
Obrigatório para visualizações de links. Uma lista de acionadores para visualização de links em um arquivo dos Documentos, Planilhas ou Apresentações Google. Saiba mais em Visualizar links com ícones inteligentes. |
createActionTriggers[] |
Obrigatório para a criação de recursos de terceiros. Uma lista de gatilhos para criar recursos em um serviço de terceiros no menu @. Saiba mais em Criar recursos de terceiros com ícones inteligentes. |
OnFileScopeGrantedTrigger
Configuração para um gatilho contextual que é disparado quando a
caixa de diálogo do escopo do arquivo de solicitação usando CardService.newEditorFileScopeActionResponseBuilder()
.requestFileScopeForActiveDocument().build();
e o usuário concede a autorização do
escopo drive.file
.
Representação JSON |
---|
{ "runFunction": string } |
Campos | |
---|---|
runFunction |
drive.file for concedido. Se especificada, você precisa implementar essa função para criar e retornar uma matriz de objetos
Card para exibição na IU do complemento.
|
LinkPreviewTriggers
Configuração de um acionador que é disparado quando um usuário digita ou cola um link de um serviço de terceiros ou de terceiros em um arquivo dos Documentos, Planilhas ou Apresentações.
Se quiser configurar esse acionador para um complemento do Google Workspace, consulte Visualizar links com ícones inteligentes.
Representação JSON |
---|
{ "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, "patterns": [ { object(patterns) } ] } |
Campos | |
---|---|
labelText |
Example: Support case . Esse texto é estático e aparece antes de os usuários executarem o complemento.
|
localizedLabelText |
labelText para localização em outros idiomas. Formate o idioma
em ISO 639 e o país/região em
ISO 3166,
separados por um hífen - . Por exemplo, en-US .
Se a localidade de um usuário estiver presente nas chaves do mapa, ele vai conferir a versão localizada do |
patterns[] |
|
runFunction |
https://www.googleapis.com/auth/workspace.linkpreview .
Se especificada, você precisa implementar essa função para aceitar um objeto de evento que contenha EDITOR_NAME.matchedUrl.url como argumento e retornar um único objeto
Card que exibe uma visualização de link na interface do complemento.
|
logoUrl |
logoUrl .
|
UriPattern
A configuração de cada padrão de URL que aciona uma visualização de link.
Representação JSON |
---|
{ "hostPattern": string, "pathPrefix" : string } |
Campos | |
---|---|
hostPattern |
subdomain.example.com , inclua o subdomínio.
Para visualizar links de todo o domínio, especifique um caractere curinga com um asterisco (* ) como subdomínio.
Por exemplo, |
pathPrefix |
hostPattern .
Por exemplo, se o padrão de host do URL for Para corresponder a todos os URLs no domínio do padrão do host, deixe |
CreateActionTriggers
A configuração de um acionador que é disparado quando um usuário seleciona um item do menu de integração de terceiros no menu @ dos Documentos Google.
Para configurar esse gatilho para um complemento do Google Workspace, consulte Criar recursos de terceiros com ícones inteligentes.
Representação JSON |
---|
{ "id": string, "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string, } |
Campos | |
---|---|
id |
[a-zA-Z0-9-]+. .
|
labelText |
Create support case .
|
localizedLabelText |
labelText para localização em outros idiomas. Formate o idioma
em ISO 639 e o país/região em
ISO 3166,
separados por um hífen - . Por exemplo, en-US .
Se a localidade de um usuário estiver presente nas chaves do mapa, ele vai conferir a versão localizada do |
runFunction |
|
logoUrl |
logoUrl .
|