Package google.apps.script.type

Índice

AddOnWidgetSet

O subconjunto de widgets usado por um complemento.

Campos
usedWidgets[]

WidgetType

A lista dos widgets usados em um complemento.

WidgetType

O tipo de widget. WIDGET_TYPE_UNSPECIFIED é o conjunto básico de widgets.

Enums
WIDGET_TYPE_UNSPECIFIED O conjunto de widgets padrão.
DATE_PICKER O seletor de data.
STYLED_BUTTONS Os botões estilizados incluem botões preenchidos e desativados.
PERSISTENT_FORMS Formulários persistentes permitem valores de formulário persistentes durante ações.
UPDATE_SUBJECT_AND_RECIPIENTS Atualize o assunto e os destinatários de um rascunho.
GRID_WIDGET O widget de grade.
ADDON_COMPOSE_UI_ACTION Uma ação do complemento do Gmail que se aplica à interface de escrita do complemento.

CommonAddOnManifest

Configuração de complementos compartilhada entre todos os aplicativos host de complementos.

Campos
name

string

Obrigatório. O nome de exibição do complemento.

logoUrl

string

Obrigatório. O URL da imagem do logotipo mostrada na barra de ferramentas de complementos.

layoutProperties

LayoutProperties

Propriedades de layout comuns para os cards de complementos.

addOnWidgetSet

AddOnWidgetSet

Os widgets usados no complemento. Se esse campo não for especificado, o conjunto padrão será usado.

useLocaleFromApp

bool

Define se informações de localidade serão transmitidas do app host.

homepageTrigger

HomepageExtensionPoint

Define um endpoint que será executado em qualquer contexto e em qualquer host. Todos os cards gerados por essa função vão estar sempre disponíveis para o usuário, mas eles poderão ser eclipsados por conteúdo contextual quando o complemento declarar acionadores mais direcionados.

universalActions[]

UniversalActionExtensionPoint

Define uma lista de pontos de extensão no menu de ações universal que serve como um menu de configurações para o complemento. O ponto de extensão pode ser um URL de link para abrir ou um endpoint para executar como envio de formulário.

openLinkUrlPrefixes

ListValue

Uma ação OpenLink só pode usar um URL com um esquema HTTPS, MAILTO ou TEL. Para links HTTPS, o URL também precisa corresponder a um dos prefixos especificados na lista de permissões. Se o prefixo omitir o esquema, HTTPS será usado. HTTP links são reescritos automaticamente para HTTPS links.

CreateActionExtensionPoint

A configuração de um acionador que é disparado quando um usuário invoca o fluxo de trabalho de criação de recursos em um aplicativo do Google Workspace. Saiba mais em Criar recursos de terceiros no menu @.

Campos
id

string

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

labelText

string

Obrigatório. O texto mostrado ao lado de um ícone do ponto de entrada de criação de recursos, como Create support case. Esse texto é estático e aparece antes de os usuários executarem o complemento.

localizedLabelText

map<string, string>

Opcional. Um mapa de labelText para localização em outros idiomas. Formate o idioma no formato 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 encontrar a versão localizada do labelText.

runFunction

string

Obrigatório. Endpoint a ser executado quando um fluxo de trabalho de criação de recurso é acionado para criar um link.

logoUrl

string

Opcional. O ícone do ponto de entrada de criação de recursos. Se omitido, o menu vai usar o ícone da barra de ferramentas do complemento, logoUrl.

HomepageExtensionPoint

Formato comum para declarar a visualização da página inicial de um complemento.

Campos
runFunction

string

Obrigatório. O endpoint a ser executado quando esse ponto de extensão é ativado.

enabled

BoolValue

Opcional. Se definido como false, desativa a visualização da página inicial nesse contexto.

Se não for definido, o padrão será true.

Se a visualização da página inicial personalizada de um complemento estiver desativada, um card de visão geral genérico será fornecido aos usuários.

HttpAuthorizationHeader

O cabeçalho de autorização foi enviado em solicitações HTTP de complemento.

Enums
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED Valor padrão, equivalente a SYSTEM_ID_TOKEN.
SYSTEM_ID_TOKEN Enviar um token de ID para a conta de serviço do sistema do complemento do Google Workspace específico do projeto (padrão).
USER_ID_TOKEN Envie um token de ID para o usuário final.
NONE Não envie um cabeçalho de autenticação.

HttpOptions

Opções para enviar solicitações para endpoints HTTP de complementos.

Campos
authorizationHeader

HttpAuthorizationHeader

Configuração do token enviado no cabeçalho de autorização HTTP.

LayoutProperties

Propriedades de layout do cartão compartilhadas em todos os aplicativos host de complementos.

Campos
primaryColor

string

A cor principal do complemento. Define a cor da barra de ferramentas. Se nenhuma cor primária for definida, o valor padrão fornecido pela estrutura será usado.

secondaryColor

string

A cor secundária do complemento. Define a cor dos botões. Se a cor primária for definida, mas nenhuma cor secundária for definida, a cor secundária será a mesma que a primária. Se nem a cor primária nem a secundária forem definidas, o valor padrão fornecido pelo framework vai ser usado.

useNewMaterialDesign

bool

Ativa o Material Design para cartões.

LinkPreviewExtensionPoint

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 arquivo dos Documentos, Planilhas ou Apresentações Google.

Campos
labelText

string

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

localizedLabelText

map<string, string>

Opcional. Um mapa de labelText para localização em outros idiomas. Formate o idioma no formato 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 encontrar a versão localizada do labelText.

patterns[]

UriPattern

Obrigatório. Uma matriz de padrões de URL que acionam o complemento para links de visualização.

runFunction

string

Obrigatório. Endpoint a ser executado quando uma visualização de link é acionada.

logoUrl

string

Opcional. O ícone que aparece no ícone inteligente e no card de visualização. Se omitido, o complemento usará o próprio ícone da barra de ferramentas, logoUrl.

Formato comum para declarar um item ou botão de menu que aparece em um app host.

Campos
runFunction

string

Obrigatório. O endpoint a ser executado quando esse ponto de extensão é ativado.

label

string

Obrigatório. Texto visível para o usuário que descreve a ação realizada ao ativar o ponto de extensão. Por exemplo, "Inserir fatura".

logoUrl

string

O URL da imagem do logotipo mostrada na barra de ferramentas de complementos.

Se não for definido, o padrão será o URL principal do logotipo do complemento.

UniversalActionExtensionPoint

Formato para declarar um ponto de extensão de item do menu de ações universal.

Campos
label

string

Obrigatório. Texto visível para o usuário que descreve a ação realizada ao ativar o ponto de extensão, por exemplo, "Adicionar um novo contato".

Campo de união action_type. Obrigatório. O tipo de ação compatível com um item do menu de ações universal. Pode ser um link para abrir ou um endpoint para executar. action_type pode ser apenas de um dos tipos a seguir:
runFunction

string

Endpoint a ser executado pela UniversalAction.

UriPattern

A configuração de cada padrão de URL que aciona uma visualização de link.

Campos
hostPattern

string

Obrigatório para cada padrão de URL que será visualizado. O domínio do padrão de URL. Os links de visualizações de complementos 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 da hostPattern.

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

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