- Recurso: implantação
- AddOns
- CommonAddOnManifest
- LayoutProperties
- AddOnWidgetSet
- WidgetType
- HomepageExtensionPoint
- UniversalActionExtensionPoint
- GmailAddOnManifest
- ContextualTrigger
- UnconditionalTrigger
- UniversalAction
- ComposeTrigger
- MenuItemExtensionPoint
- DraftAccess
- DriveAddOnManifest
- DriveExtensionPoint
- CalendarAddOnManifest
- ConferenceSolution
- CalendarExtensionPoint
- EventAccess
- DocsAddOnManifest
- DocsExtensionPoint
- LinkPreviewExtensionPoint
- UriPattern
- CreateActionExtensionPoint
- SheetsAddOnManifest
- SheetsExtensionPoint
- SlidesAddOnManifest
- SlidesExtensionPoint
- HttpOptions
- HttpAuthorizationHeader
- Métodos
Recurso: Deployment
Uma implantação de complemento do Google Workspace
Representação JSON |
---|
{
"name": string,
"oauthScopes": [
string
],
"addOns": {
object ( |
Campos | |
---|---|
name |
O nome do recurso de implantação. Exemplo: |
oauthScopes[] |
A lista de escopos do OAuth do Google para os quais solicitar o consentimento do usuário final antes de executar um endpoint de complemento. |
addOns |
Configuração do complemento do Google Workspace. |
etag |
Esse valor é calculado pelo servidor com base na versão da implantação no armazenamento e pode ser enviado em solicitações de atualização e exclusão para garantir que o cliente tenha um valor atualizado antes de prosseguir. |
AddOns
Configuração de um complemento do Google Workspace.
Representação JSON |
---|
{ "common": { object ( |
Campos | |
---|---|
common |
Configuração comum a todos os complementos do Google Workspace. |
gmail |
Configuração dos complementos do Gmail. |
drive |
Configuração dos complementos do Drive. |
calendar |
Configuração dos complementos do Agenda. |
docs |
Configuração de complementos do Documentos. |
sheets |
Configuração de complementos do Planilhas. |
slides |
Configuração de complementos do Apresentações. |
httpOptions |
Opções para enviar solicitações para endpoints HTTP de complementos |
CommonAddOnManifest
Configuração de complementos compartilhada em todos os aplicativos host de complementos.
Representação JSON |
---|
{ "name": string, "logoUrl": string, "layoutProperties": { object ( |
Campos | |
---|---|
name |
Obrigatório. O nome de exibição do complemento. |
logoUrl |
Obrigatório. É o URL da imagem do logotipo mostrada na barra de ferramentas do complemento. |
layoutProperties |
Propriedades de layout comuns para os cards complementares. |
addOnWidgetSet |
Os widgets usados no complemento. Se esse campo não for especificado, o conjunto padrão será usado. |
useLocaleFromApp |
Define se as informações de localidade do app host serão transmitidas. |
homepageTrigger |
Define um endpoint que será executado em qualquer contexto, em qualquer host. Todos os cards gerados por essa função sempre vão estar disponíveis para o usuário, mas podem ser eclipsados por conteúdo contextual quando o complemento declara acionadores mais segmentados. |
universalActions[] |
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 a ser aberto ou um endpoint a ser executado como envio de formulário. |
openLinkUrlPrefixes |
Uma ação do OpenLink só pode usar um URL com um esquema |
LayoutProperties
Propriedades de layout de cartão compartilhadas em todos os aplicativos host de complementos.
Representação JSON |
---|
{ "primaryColor": string, "secondaryColor": string, "useNewMaterialDesign": boolean } |
Campos | |
---|---|
primaryColor |
A cor principal do complemento. Define a cor da barra de ferramentas. Se nenhuma cor primária for definida, o valor padrão fornecido pelo framework será usado. |
secondaryColor |
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, será usado o valor padrão fornecido pelo framework. |
useNewMaterialDesign |
Ativa o Material Design para cartões. |
AddOnWidgetSet
O subconjunto de widgets usado por um complemento.
Representação JSON |
---|
{
"usedWidgets": [
enum ( |
Campos | |
---|---|
usedWidgets[] |
A lista de widgets usados em um complemento. |
WidgetType
O tipo de widget. WIDGET_TYPE_UNSPECIFIED
é o widget básico definido.
Enums | |
---|---|
WIDGET_TYPE_UNSPECIFIED |
O widget padrão definido. |
DATE_PICKER |
O seletor de data. |
STYLED_BUTTONS |
Os botões estilizados incluem botões preenchidos e desativados. |
PERSISTENT_FORMS |
Formulários persistentes permitem a persistência de valores de formulário durante as ações. |
FIXED_FOOTER |
Rodapé corrigido em um card. |
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. |
HomepageExtensionPoint
Formato comum para declarar a visualização da página inicial de um complemento.
Representação JSON |
---|
{ "runFunction": string, "enabled": boolean } |
Campos | |
---|---|
runFunction |
Obrigatório. O endpoint a ser executado quando esse ponto de extensão for ativado. |
enabled |
Opcional. Se definido como Se não definido, o padrão será Se a visualização da página inicial personalizada de um complemento estiver desativada, um card de visão geral genérico vai aparecer para os usuários. |
UniversalActionExtensionPoint
Formato para declarar um ponto de extensão do item de menu de ações universal.
Representação JSON |
---|
{ "label": string, // Union field |
Campos | |
---|---|
label |
Obrigatório. Texto visível para o usuário que descreve a ação realizada ao ativar este 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 a ser aberto ou um endpoint a ser executado. action_type pode ser apenas de um dos tipos a seguir: |
|
openLink |
URL que será aberto pela UniversalAction. |
runFunction |
Endpoint a ser executado pela UniversalAction. |
GmailAddOnManifest
Propriedades que personalizam a aparência e a execução de um complemento do Gmail.
Representação JSON |
---|
{ "homepageTrigger": { object ( |
Campos | |
---|---|
homepageTrigger |
Define um endpoint que será executado em contextos que não correspondem a um gatilho contextual declarado. Todos os cards gerados por essa função sempre estarão disponíveis para o usuário, mas poderão ser eclipsados por conteúdo contextual quando o complemento declarar acionadores mais segmentados. Se presente, substitui a configuração de |
contextualTriggers[] |
Define o conjunto de condições que acionam o complemento. |
universalActions[] |
Define um conjunto de ações universais para o complemento. O usuário aciona ações universais no menu da barra de ferramentas do complemento. |
composeTrigger |
Define o gatilho de tempo do Compose para um complemento desse tipo. Este é o gatilho que faz com que um complemento entre em ação quando o usuário estiver escrevendo um e-mail. Todos os complementos do Compose precisam ter o escopo |
authorizationCheckFunction |
O nome de um endpoint que verifica se o complemento tem todas as autorizações de terceiros necessárias, analisando as APIs de terceiros. Se a sondagem falhar, a função vai gerar uma exceção para iniciar o fluxo de autorização. Essa função é chamada antes de cada invocação do complemento para garantir uma boa experiência do usuário. |
ContextualTrigger
Define um acionador que é disparado quando o e-mail aberto atende a um critério específico. Quando o gatilho é disparado, ele executa um endpoint específico, geralmente para criar novos cards e atualizar a interface.
Representação JSON |
---|
{ "onTriggerFunction": string, // Union field |
Campos | |
---|---|
onTriggerFunction |
Obrigatório. O nome do endpoint a ser chamado quando uma mensagem corresponder ao gatilho. |
Campo de união trigger . O tipo de acionador determina as condições que o Gmail usa para mostrar o complemento. trigger pode ser apenas de um dos tipos a seguir: |
|
unconditional |
Acionadores incondicionais são executados quando qualquer mensagem de e-mail é aberta. |
UnconditionalTrigger
Esse tipo não tem campos.
Um acionador que dispara quando qualquer mensagem de e-mail é aberta.
UniversalAction
Uma ação que está sempre disponível no menu da barra de ferramentas do complemento, independentemente do contexto da mensagem.
Representação JSON |
---|
{ "text": string, // Union field |
Campos | |
---|---|
text |
Obrigatório. Texto visível para o usuário descrevendo a ação, por exemplo, "Adicionar um novo contato". |
Campo de união action_type . O tipo da ação determina o comportamento do Gmail quando o usuário invoca a ação. action_type pode ser apenas de um dos tipos a seguir: |
|
openLink |
Um link que é aberto pelo Gmail quando o usuário aciona a ação. |
runFunction |
Um endpoint que é chamado quando o usuário aciona a ação. Consulte o guia de ações universais para mais detalhes. |
ComposeTrigger
Um gatilho que é ativado quando o usuário está escrevendo um e-mail.
Representação JSON |
---|
{ "actions": [ { object ( |
Campos | |
---|---|
actions[] |
Define o conjunto de ações para um complemento de tempo de composição. São ações que os usuários podem acionar em um complemento de tempo de escrita. |
draftAccess |
Define o nível de acesso aos dados quando um complemento de tempo de escrita é acionado. |
MenuItemExtensionPoint
Formato comum para declarar um item ou botão de menu que aparece em um aplicativo host.
Representação JSON |
---|
{ "runFunction": string, "label": string, "logoUrl": string } |
Campos | |
---|---|
runFunction |
Obrigatório. O endpoint a ser executado quando esse ponto de extensão for ativado. |
label |
Obrigatório. Texto visível para o usuário que descreve a ação realizada ao ativar esse ponto de extensão. Por exemplo, "Inserir fatura". |
logoUrl |
É o URL da imagem do logotipo mostrada na barra de ferramentas do complemento. Se ela não for definida, o padrão será o URL do logotipo principal do complemento. |
DraftAccess
Um tipo enumerado que define o nível de acesso a dados que o gatilho de composição exige.
Enums | |
---|---|
UNSPECIFIED |
Valor padrão quando nada está definido para rascunhoaccess. |
NONE |
O gatilho do Compose não pode acessar os dados do rascunho quando um complemento do Compose é acionado. |
METADATA |
Concede ao gatilho do Compose a permissão para acessar os metadados do rascunho quando um complemento do Compose é acionado. Isso inclui a lista de público-alvo, como as listas "Para" e "Cc" da mensagem de rascunho. |
DriveAddOnManifest
Propriedades que personalizam a aparência e a execução de um complemento do Drive.
Representação JSON |
---|
{ "homepageTrigger": { object ( |
Campos | |
---|---|
homepageTrigger |
Se presente, substitui a configuração de |
onItemsSelectedTrigger |
Corresponde ao comportamento que é executado quando os itens são selecionados na visualização relevante do Google Drive, como a lista de documentos do Meu Drive. |
DriveExtensionPoint
Formato comum para declarar acionadores de um complemento do Drive.
Representação JSON |
---|
{ "runFunction": string } |
Campos | |
---|---|
runFunction |
Obrigatório. O endpoint a ser executado quando o ponto de extensão for ativado. |
CalendarAddOnManifest
Propriedades que personalizam a aparência e a execução de um complemento do Agenda.
Representação JSON |
---|
{ "homepageTrigger": { object ( |
Campos | |
---|---|
homepageTrigger |
Define um endpoint que é executado em contextos que não correspondem a um gatilho contextual declarado. Todos os cards gerados por essa função sempre vão estar disponíveis para o usuário, mas podem ser eclipsados por conteúdo contextual quando o complemento declara acionadores mais segmentados. Se presente, substitui a configuração de |
conferenceSolution[] |
Define as soluções de conferência fornecidas por este complemento. |
createSettingsUrlFunction |
Um endpoint a ser executado que cria um URL para a página de configurações do complemento. |
eventOpenTrigger |
Um endpoint que é acionado quando um evento é aberto para visualização ou edição. |
eventUpdateTrigger |
Um endpoint que é acionado quando o evento aberto é atualizado. |
eventAttachmentTrigger |
Uma configuração para um acionador contextual acionado quando o usuário clica no provedor de anexos de complementos no menu suspenso do Google Agenda. |
currentEventAccess |
Define o nível de acesso aos dados quando um complemento do evento é acionado. |
ConferenceSolution
Define valores relacionados à conferência.
Representação JSON |
---|
{ "onCreateFunction": string, "id": string, "name": string, "logoUrl": string } |
Campos | |
---|---|
onCreateFunction |
Obrigatório. O endpoint a ser chamado quando os dados de videoconferência forem criados. |
id |
Obrigatório. Os IDs devem ser atribuídos de maneira exclusiva a todas as soluções de conferência dentro de um complemento. Caso contrário, a solução de conferência errada poderá ser usada quando o complemento for acionado. Embora seja possível alterar o nome de exibição de um complemento, o código não deve ser alterado. |
name |
Obrigatório. O nome de exibição da solução de conferência. |
logoUrl |
Obrigatório. O URL para a imagem do logotipo da solução de conferência. |
CalendarExtensionPoint
Formato comum para declarar acionadores de complementos de agenda.
Representação JSON |
---|
{ "runFunction": string } |
Campos | |
---|---|
runFunction |
Obrigatório. O endpoint a ser executado quando esse ponto de extensão for ativado. |
EventAccess
Um tipo enumerado que define o nível necessário para os acionadores de eventos de acesso a dados.
Enums | |
---|---|
UNSPECIFIED |
Valor padrão quando nada é definido para eventAccess. |
METADATA |
Concede aos acionadores do evento permissão para acessar os metadados dos eventos, como os IDs do evento e da agenda. |
READ |
Concede aos acionadores do evento acesso a todos os campos do evento, incluindo metadados, convidados e dados da conferência. |
WRITE |
Concede aos acionadores do evento acesso aos metadados dos eventos e a capacidade de realizar todas as ações, incluindo adicionar participantes e configurar dados da conferência. |
READ_WRITE |
Concede aos acionadores do evento acesso a todos os campos do evento, incluindo metadados, convidados e dados da conferência, além da capacidade de realizar todas as ações. |
DocsAddOnManifest
Propriedades que personalizam a aparência e a execução de um complemento do Documentos Google.
Representação JSON |
---|
{ "homepageTrigger": { object ( |
Campos | |
---|---|
homepageTrigger |
Se presente, substitui a configuração de |
onFileScopeGrantedTrigger |
Endpoint a ser executado quando a autorização do escopo do arquivo for concedida para este par de documento/usuário. |
linkPreviewTriggers[] |
Uma lista de pontos de extensão para visualizar links em um documento do Documentos Google. Saiba mais em Visualizar links com ícones inteligentes. |
createActionTriggers[] |
Uma lista de pontos de extensão para criar recursos de terceiros nos aplicativos do Google Workspace. Para mais informações, consulte Criar recursos de terceiros no menu @. |
DocsExtensionPoint
Formato comum para declarar acionadores de um complemento do Documentos Google.
Representação JSON |
---|
{ "runFunction": string } |
Campos | |
---|---|
runFunction |
Obrigatório. O endpoint a ser executado quando esse ponto de extensão for ativado. |
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 do Documentos, Planilhas ou Apresentações Google.
Representação JSON |
---|
{
"labelText": string,
"localizedLabelText": {
string: string,
...
},
"patterns": [
{
object ( |
Campos | |
---|---|
labelText |
Obrigatório. O texto de um exemplo de ícone inteligente que solicita que os usuários visualizem o link, como |
localizedLabelText |
Opcional. Um mapa de Se a localidade de um usuário estiver presente nas chaves do mapa, ele vai encontrar a versão localizada do Um objeto com uma lista de pares |
patterns[] |
Obrigatório. Uma matriz de padrões do URL que aciona o complemento para visualizar links. |
runFunction |
Obrigatório. Endpoint a ser executado quando uma visualização de link for acionada. |
logoUrl |
Opcional. O ícone que aparece no ícone inteligente e no card de visualização. Se omitido, o complemento vai usar o ícone |
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 |
Obrigatório para cada padrão de URL a ser visualizado. O domínio do padrão do URL. O complemento mostra os links que contêm esse domínio no URL. Para visualizar links de um subdomínio específico, como Por exemplo, |
pathPrefix |
Opcional. O caminho que anexa o domínio de Por exemplo, se o padrão do host do URL for Para corresponder a todos os URLs no domínio do padrão de host, deixe |
CreateActionExtensionPoint
A configuração de um gatilho que é disparado quando um usuário invoca o fluxo de trabalho de criação de recursos em um aplicativo do Google Workspace. Para mais informações, consulte Criar recursos de terceiros no menu @.
Representação JSON |
---|
{ "id": string, "labelText": string, "localizedLabelText": { string: string, ... }, "runFunction": string, "logoUrl": string } |
Campos | |
---|---|
id |
Obrigatório. O ID exclusivo para diferenciar esse ponto de extensão. O ID pode ter até 64 caracteres e precisa estar no formato |
labelText |
Obrigatório. O texto exibido ao lado de um ícone do ponto de entrada de criação de recursos, como |
localizedLabelText |
Opcional. Um mapa de Se a localidade de um usuário estiver presente nas chaves do mapa, ele vai encontrar a versão localizada do Um objeto com uma lista de pares |
runFunction |
Obrigatório. Endpoint a ser executado quando um fluxo de trabalho de criação de recurso for acionado para criar um link. |
logoUrl |
Opcional. O ícone do ponto de entrada de criação de recursos. Se ele for omitido, o menu vai usar o ícone |
SheetsAddOnManifest
Propriedades que personalizam a aparência e a execução de um complemento do Planilhas Google.
Representação JSON |
---|
{ "homepageTrigger": { object ( |
Campos | |
---|---|
homepageTrigger |
Se presente, substitui a configuração de |
onFileScopeGrantedTrigger |
Endpoint a ser executado quando a autorização do escopo do arquivo for concedida para este par de documento/usuário. |
linkPreviewTriggers[] |
Uma lista de pontos de extensão para visualizar links em um documento do Planilhas Google. Saiba mais em Visualizar links com ícones inteligentes. |
SheetsExtensionPoint
Formato comum para declarar acionadores de um complemento do Planilhas.
Representação JSON |
---|
{ "runFunction": string } |
Campos | |
---|---|
runFunction |
Obrigatório. O endpoint a ser executado quando esse ponto de extensão for ativado. |
SlidesAddOnManifest
Propriedades que personalizam a aparência e a execução de um complemento do Apresentações Google.
Representação JSON |
---|
{ "homepageTrigger": { object ( |
Campos | |
---|---|
homepageTrigger |
Se presente, substitui a configuração de |
onFileScopeGrantedTrigger |
Endpoint a ser executado quando a autorização do escopo do arquivo for concedida para este par de documento/usuário. |
linkPreviewTriggers[] |
Uma lista de pontos de extensão para visualizar links em um documento das Apresentações Google. Saiba mais em Visualizar links com ícones inteligentes. |
SlidesExtensionPoint
Formato comum para declarar acionadores de um complemento do Apresentações.
Representação JSON |
---|
{ "runFunction": string } |
Campos | |
---|---|
runFunction |
Obrigatório. O endpoint a ser executado quando esse ponto de extensão for ativado. |
HttpOptions
Opções para enviar solicitações aos endpoints do complemento HTTP
.
Representação JSON |
---|
{
"authorizationHeader": enum ( |
Campos | |
---|---|
authorizationHeader |
Configuração do token enviado no cabeçalho de autorização |
HttpAuthorizationHeader
Cabeçalho de autorização enviado nas solicitações HTTP
de complementos.
Enums | |
---|---|
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED |
Valor padrão, equivalente a SYSTEM_ID_TOKEN . |
SYSTEM_ID_TOKEN |
Envie 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. |
Métodos |
|
---|---|
|
Cria uma implantação com o nome e a configuração especificados. |
|
Exclui a implantação com o nome fornecido. |
|
Recebe a implantação com o nome especificado. |
|
Recebe o status da instalação de uma implantação de teste. |
|
Instala uma implantação na sua conta para teste. |
|
Lista todas as implantações em um projeto específico. |
|
Cria ou substitui uma implantação com o nome especificado. |
|
Desinstala uma implantação de teste da conta do usuário. |