Recurso de manifesto do editor

A configuração de recursos usada para definir o conteúdo e o comportamento dos complementos do Google Workspace nos editores. Os manifestos de complementos do Google Workspace precisam ter todos os componentes marcados como obrigatórios se eles estenderem o editor.

Editores

Configuração do manifesto do complemento 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)
      }
    ]
  }
Campos
homepageTrigger

object (HomepageTrigger)

Esta função de gatilho cria a página inicial do complemento no app host. Isso substitui addOns.common.homepageTrigger.

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Obrigatório se o complemento incluir um comportamento específico para o documento atual do Editor, acionado quando o usuário autoriza o escopo drive.file .

linkPreviewTriggers[]

object (LinkPreviewTriggers)

Obrigatório para visualizações de links. Uma lista de acionadores para a visualização de links em um arquivo dos Documentos Google. Veja mais detalhes em Visualizar links com ícones inteligentes.

OnFileScopegrantedTrigger

Uma configuração para um acionador 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 autorização de escopo drive.file.

Representação JSON
{
  "runFunction": string
}
Campos
runFunction

string

O nome da função a ser executada se o escopo 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

A 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 documento do Documentos Google.

Se quiser configurar esse acionador para um complemento do Google Workspace, consulte Visualizar links com ícones inteligentes.

Representação JSON
{
  "labelText": string,
  "runFunction": string,
  "logoUrl": string,
  "patterns": [
    {
      object(patterns)
    }
  ]
}
Campos
labelText

string

Obrigatório. O texto de um exemplo de ícone inteligente que solicita que os usuários visualizem o link, por exemplo, Example: Support case. Esse texto é estático e exibido antes de os usuários executarem o complemento.
localizedLabelText

map

Opcional. Um mapa de labelText para localização em outros idiomas. Formate o idioma no formato ISO 639 e o país/região na 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 encontrar a versão localizada do labelText.

patterns[]

object (UriPattern)

Obrigatório. Uma matriz de padrões de URL que acionam o complemento para visualizar links.
runFunction

string

Obrigatório. O nome da função a ser executada quando o usuário autorizar o escopo https://www.googleapis.com/auth/workspace.linkpreview. Se especificada, você precisa implementar essa função para aceitar um objeto de evento contendo docs.matchedUrl.url como argumento e retornar um único objeto Card que exibe uma visualização de link na IU do complemento.
logoUrl

string

Opcional. É o ícone exibido no ícone inteligente. Se omitido, o ícone usará o ícone da barra de ferramentas do complemento, logoUrl.

Padrão URI

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

string

Obrigatório para cada padrão de URL a ser visualizado. O domínio do padrão de URL. Os complementos de visualizações dos links que contêm este domínio no URL. Para visualizar links de um subdomínio específico, como subdomain.example.com, inclua o subdomínio. Para visualizar links para todo o domínio, especifique um caractere curinga com um asterisco (*) como subdomínio.

Por exemplo, *.example.com corresponde a subdomain.example.com e another.subdomain.example.com.

pathPrefix

string

Opcional. O caminho que anexa o domínio do hostPattern.

Por exemplo, se o padrão de host do URL for support.example.com, use cases para corresponder aos URLs dos casos hospedados em support.example.com/cases/.

Para corresponder a todos os URLs no domínio do padrão de host, deixe pathPrefix em branco.