Recurso de manifesto de complementos

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

Complementos

O nível superior da configuração do manifesto do complemento do Google Workspace.

Representação JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
Campos
common

object (Common)

Obrigatório. Define valores para um complemento do Google Workspace que são comuns a todos os aplicativos host. Alguns valores definidos aqui são usados como padrão quando valores específicos de um host específico são omitidos.

calendar

object (Calendar)

Obrigatório se o complemento do Google Workspace estender o Google Agenda. Configurações da aparência e do comportamento dos complementos do Google Workspace no aplicativo host do Google Agenda. Se esse campo for omitido, o complemento será desativado no Google Agenda.

drive

object (Drive)

Obrigatório se o complemento do Google Workspace estender o Google Drive. Configurações da aparência e do comportamento do complemento do Google Workspace no aplicativo host do Google Drive. Se esse campo for omitido, o complemento será desativado no Google Drive.

gmail

object (Gmail)

Obrigatório se o complemento do Google Workspace estender o Gmail. Configurações da aparência e do comportamento dos complementos do Google Workspace no aplicativo host do Gmail. Se esse campo for omitido, o complemento será desativado no Gmail.

docs

object (Docs)

Obrigatório se o complemento do Google Workspace estender o Documentos Google. Configurações da aparência e do comportamento do complemento do Google Workspace no aplicativo host do Documentos. Se esse campo for omitido, o complemento será desativado no Documentos.

sheets

object (Sheets)

Obrigatório se o complemento do Google Workspace estender as Planilhas. Configurações da aparência e do comportamento do complemento do Google Workspace no aplicativo host do Planilhas. Se esse campo for omitido, o complemento será desativado no Planilhas.

slides

object (Slides)

Obrigatório se o complemento do Google Workspace estender as Apresentações. Configurações da aparência e do comportamento do complemento do Google Workspace no aplicativo host das Apresentações. Se esse campo for omitido, o complemento será desativado no Apresentações.

Nome

A configuração do manifesto para parâmetros comuns a todos os aplicativos host. Alguns valores definidos aqui são usados como padrão quando valores específicos de um host específico são omitidos.

Representação JSON
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
Campos
homepageTrigger

object (HomepageTrigger)

A especificação da função de gatilho padrão para criar a página inicial do complemento. Essa especificação será usada se um gatilho de página inicial específico do host não for definido. Se esse atributo também for omitido, um cartão genérico da página inicial será criado e usado quando necessário.
layoutProperties

object (LayoutProperties)

Uma configuração das cores usadas na barra de ferramentas e nos botões do complemento.
logoUrl

string

Obrigatório. O URL da imagem mostrada na barra de ferramentas. O URL precisa ser público.

name

string

Obrigatório. O nome do complemento mostrado na barra de ferramentas.

openLinkUrlPrefixes[]

string

Obrigatório se o complemento exibir links externos, seja em widgets usando um OpenLink ou widget de texto usando tags de âncora HTML. Uma lista de prefixos de URL HTTPS. Para proteger os dados do usuário, qualquer link renderizado pelo complemento precisa corresponder a um dos prefixos desta lista.

Consulte Adicionar URLs à lista de permissões para saber mais.

universalActions[]

object (UniversalAction)

Lista de ações universais que estão sempre disponíveis na IU do complemento.
useLocaleFromApp

boolean

Se for true, os objetos de evento do complemento transmitidos para as funções de callback de ação ou as funções do acionador vão incluir as informações de localidade e fuso horário do usuário. O padrão é false.

Consulte Acessar a localidade e os fusos horários do usuário para saber mais.

Propriedades de layout

Uma configuração que controla as cores e a aparência do botão e da barra de ferramentas do complemento Google Workspace.

Representação JSON
{
  "primaryColor": string,
  "secondaryColor": string
}
Campos
primaryColor

string

A cor da barra de ferramentas. O padrão é cinza (#424242).
secondaryColor

string

A cor padrão dos botões. O padrão é a cor primária (se estiver definida). Caso contrário, o padrão é azul (#2196F3).

UniversalAction.

Uma configuração para uma ação universal. Quando selecionada, uma ação universal abre o link do URL especificado ou executa a função especificada do Apps Script.

Representação JSON
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
Campos
label

string

Obrigatório para todas as ações universais. O texto mostrado no menu da IU para a ação.
runFunction

string

Obrigatório para cada ação universal se openLink não estiver presente. Se fornecido, o nome da função do Apps Script executada quando o usuário seleciona essa ação.

Consulte o guia Ações universais para mais detalhes.