Recurso de manifesto do editor

A configuração de recursos usada para definir o conteúdo e o comportamento do complemento 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

A configuração do manifesto de complementos do Google Workspace para Extensões do editor. Consulte Estender os 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

object (HomepageTrigger)

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

onFileScopeGrantedTrigger

object (OnFileScopeGrantedTrigger)

Obrigatório se o complemento incluir um comportamento específico da atual Documento 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 gatilhos para visualizar links em um arquivo dos Documentos, Planilhas ou Apresentações Google. Saiba mais em Visualizar links com ícones inteligentes.

createActionTriggers[]

object (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

Uma configuração para um acionador contextual que é disparado quando a a caixa de diálogo da solicitação de escopo do arquivo usando CardService.newEditorFileScopeActionResponseBuilder() .requestFileScopeForActiveDocument().build();, e o usuário concede drive.file de escopo.

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

string

O nome da função a ser executada se o escopo drive.file for concedido. Se especificado, você deve implementar esta função para criar e retornar uma matriz de Objetos Card para exibição na interface 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 que não é do Google para um arquivo dos Documentos, Planilhas ou Apresentações Google.

Para configurar esse gatilho em um complemento do Google Workspace, ver Acesse a prévia de links com ícones inteligentes.

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

string

Obrigatório. Texto de um exemplo de ícone inteligente que solicita aos usuários para visualizar o link, como Example: Support case. Esse texto é estático e aparece antes que os usuários executem o complemento.
localizedLabelText

map (key: string, value: string)

Opcional. Um mapa de labelText para localizar em outros idiomas. Formatar o idioma no formato ISO 639 e país/região do ISO 3166, separadas por um hífen -. Por exemplo, en-US.

Se a localidade de um usuário estiver presente nas chaves do mapa, ele verá o versão localizada do labelText.

patterns[]

object (UriPattern)

Obrigatório. Uma matriz de padrões do URL que aciona 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 especificado, você deve implementar essa função para aceitar um objeto de evento contendo EDITOR_NAME.matchedUrl.url como um argumento e retornar um único Objeto Card que mostra uma visualização de link na interface do complemento.
logoUrl

string

Opcional. O ícone que aparece no ícone inteligente e no card de visualização. Se omitido, o complemento vai usar o ícone logoUrl na barra de ferramentas.

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

string

Obrigatório para cada padrão de URL a ser visualizado. O domínio do padrão de URL. O complemento mostra os links que contêm esse domínio no URL. Para visualizar links de um subdomínio específico, como 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, *.example.com corresponde a subdomain.example.com. e another.subdomain.example.com.

pathPrefix

string

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

Por exemplo, se o padrão do host do URL for support.example.com, use cases para fazer a correspondência dos URLs com 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.

CreateActionTriggers

A configuração de um acionador que é disparado quando um usuário seleciona um terceiro item do menu de integração a partir do menu @ do Google Docs.

Para configurar esse gatilho em um complemento do Google Workspace, ver Criar recursos de terceiros com ícones inteligentes.

Representação JSON
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string,
}
Campos
id

string

Obrigatório. O ID exclusivo para diferenciar esta extensão ponto O ID pode ter até 64 caracteres e deve estar no formato [a-zA-Z0-9-]+.:
labelText

string

Obrigatório. O texto que aparece no caractere @ por exemplo, Create support case.
localizedLabelText

map (key: string, value: string)

Opcional. Um mapa de labelText para localizar em outros idiomas. Formatar o idioma no formato ISO 639 e país/região do ISO 3166, separadas por um hífen -. Por exemplo, en-US.

Se a localidade de um usuário estiver presente nas chaves do mapa, ele verá o versão localizada do labelText.

runFunction

string

Obrigatório. O nome da função a ser executada quando um usuário seleciona um ponto de extensão no menu @. A função precisa retornar um cartão de formulário com entradas para criar o recurso de terceiros.
logoUrl

string

Opcional. O ícone exibido no menu @. Se omitido, o complemento vai usar o ícone logoUrl na barra de ferramentas.