Glossário

Os termos a seguir são usados em toda esta documentação.

Complemento de conferências da Agenda

Um tipo especial de complemento usado para permitir que os provedores de videoconferência apresentem opções de videoconferência em eventos do Google Agenda. Esses complementos exigem uma solução de conferência bem desenvolvida para se conectarem. Por causa desse requisito, a maioria dos desenvolvedores nunca precisa criar um complemento de videoconferências da Agenda.

Consulte Complementos de videoconferências do Agenda para mais informações. Consulte também Atualizar seus complementos publicados para saber como converter um complemento de videoconferências do Agenda em um do Google Workspace.

Cartas

Uma única "página" da interface de um complemento. Os cards são compostos por diferentes objetos de widget (botões, campos de texto, cabeçalhos etc.).

Consulte Cards para mais informações.

Com base em cards

Um complemento cuja interface do usuário aparece como um painel na barra lateral ou, em dispositivos móveis, como outra janela de atividade acessada pelo menu. O complemento tem uma barra de ferramentas superior que identifica o complemento e exibe um card, ou seja, uma "página" da interface do complemento.

Os complementos do Google Workspace são baseados em cards.

Dados da conferência

O conjunto de informações que o Google Agenda precisa para permitir que os usuários criem e participem de conferências de terceiros ativadas por um complemento do Google Workspace ou de videoconferências do Google Agenda.

Consulte Dados da conferência para mais informações.

Solução de videoconferência

Representação de uma conferência de terceiros que pode ser criada no Google Agenda usando o complemento do Google Workspace ou o complemento de videoconferência do Agenda.

Consulte Soluções de conferência para mais informações.

Contexto

O estado atual do aplicativo host. Por exemplo, qual mensagem está aberta no Gmail, qual evento do Google Agenda você está editando ou quais arquivos do Drive você selecionou fazem parte do contexto atual do aplicativo host. O contexto, junto com outras informações, é coletado em um objeto de evento que é transmitido à função de acionamento como um parâmetro.

Acionamento contextual

A prática de definir gatilhos que são acionados quando o usuário entra em um contexto específico, como quando ele abre uma conversa de e-mail no Gmail. O acionamento contextual permite que o complemento forneça uma interface relevante para esse contexto. Os acionadores contextuais são configurados no manifesto do projeto do script do complemento e, portanto, são um tipo de acionador de manifesto.

Complementos do editor

O conjunto original de tipos de complementos que permitia apenas extensões dos apps Documentos, Planilhas, Formulários ou Apresentações Google. Os complementos do editor não são baseados em cards. Em vez disso, eles exigem que o desenvolvedor crie uma interface usando HTML e CSS brutos. Cada complemento do editor só pode estender um aplicativo host.

Consulte Complementos do editor para mais detalhes.

Objeto de evento

O objeto JSON que é criado automaticamente quando as páginas iniciais são solicitadas, quando o complemento entra em contextos aos quais precisa responder ou como resultado das interações do usuário com widgets na interface do complemento. Depois de criados, os objetos de evento são transmitidos para uma função de callback ou de acionamento especificada. O objetivo dos objetos de evento é transmitir informações do ambiente do lado do cliente do usuário (como informações inseridas nos widgets da interface do complemento) para o código do lado do servidor do complemento, que pode agir com base nessas informações e retornar a resposta adequada.

Consulte Objetos de evento para mais detalhes.

Complementos do Gmail

Um complemento que estende apenas o Gmail. Os complementos do Gmail são baseados em cards. Grande parte da funcionalidade, comportamento e detalhes de desenvolvimento usados para criar complementos do Gmail é idêntica aos mesmos detalhes usados para criar complementos do Google Workspace.

Consulte Complementos do Gmail para mais informações. Consulte também Atualizar seus complementos publicados para saber como converter um complemento do Gmail em um do Google Workspace.

Página inicial

O card da IU raiz de um complemento. As páginas iniciais são exibidas quando os usuários abrem o complemento e permitem que ele mostre conteúdo fora de um contexto específico (por exemplo, quando o usuário está visualizando as conversas de e-mail no Gmail, mas não abriu uma delas). Você define a aparência e o comportamento da página inicial do complemento como qualquer outro card.

Consulte Páginas iniciais para mais informações.

Host ou aplicativo host

O aplicativo do Google Workspace que um complemento do Google Workspace estende, como o Gmail ou o Google Agenda.

Com base em HTML

Um complemento cuja interface do usuário é definida usando HTML e CSS em vez do serviço de cartão integrado do Apps Script. Somente os complementos do editor mais antigos são baseados em HTML.

A visualização de link é acionada quando os usuários interagem com um URL de terceiros ou que não é do Google em um aplicativo host do Google, como o Documentos Google. O acionamento da visualização do link permite definir padrões de URL para visualização do seu serviço ou API e configurar o conteúdo da visualização, incluindo o ícone inteligente e o card de visualização. Os acionadores de pré-visualização de links são configurados no manifesto do projeto do script do complemento e, portanto, são um tipo de acionador de manifesto.

Consulte Conferir prévias de links com ícones inteligentes para mais informações.

Manifesto

Um arquivo JSON anexado a um projeto do Apps Script. O manifesto é usado para definir informações do projeto que o script precisa executar corretamente. Para complementos do Google Workspace, o manifesto é usado para especificar quais hosts o complemento pode estender e fornecer certas configurações de controle da interface.

Acionamento de manifesto

Um acionador definido no manifesto de um projeto, como um acionador de página inicial ou contextual. Os acionadores de manifesto são usados exclusivamente para criar e mostrar novos cards quando uma página inicial de complemento é solicitada ou o complemento entra em um contexto que exige uma atualização de exibição.

Os acionadores de manifesto são diferentes dos outros acionadores no Apps Script porque não são integrados (como acionadores simples) e não podem ser criados programaticamente com o serviço de script do Apps Script (como acionadores instaláveis).

Cards não contextuais

Cards que mostram conteúdo quando o usuário está fora de um contexto específico. Por exemplo, quando ele está visualizando as conversas de e-mail no Gmail, mas não abriu nenhuma. As páginas iniciais são um tipo de card não contextual.

A seção à direita da interface do host, onde a interface de um complemento do Google Workspace aparece. Os complementos do Gmail e do Editor também podem definir barras laterais.

Ícone inteligente

Um ícone inteligente é uma menção a uma pessoa, um arquivo, um evento da agenda ou outra entidade em um app do Google Workspace. Quando os usuários passam o cursor sobre um ícone, eles também podem visualizar o conteúdo adicional sobre o arquivo ou link. Por exemplo, quando os usuários passam o cursor sobre um ícone de uma apresentação do Google Apresentações, eles veem uma captura de tela de um slide, o proprietário da apresentação e se já a acessaram antes.

É possível configurar o complemento para usar ícones inteligentes e mostrar links de um serviço de terceiros ou de outro provedor. Consulte Visualizar links nos Documentos Google.

Gatilho

Uma condição e uma resposta automática a eventos definidos por um projeto ou complemento do Apps Script. Os acionadores são acionados quando o evento associado ocorre (por exemplo, quando um complemento é aberto) e fazem com que uma função do Apps Script especificada (a função do acionador) seja executada automaticamente. Para complementos do Google Workspace, as funções de acionamento geralmente criam novos cards para controlar qual parte da interface do complemento é exibida. Apenas determinados tipos de evento podem ter acionadores.

Consulte acionadores de complementos para mais informações.

Função de acionamento

Uma função do Apps Script em um projeto que é executada em resposta a um gatilho sendo acionado.

Widget

Um elemento da interface, como um botão, campo de texto ou caixa de seleção. Os cards são criados a partir de uma sequência de objetos de widget, definidos pelo serviço de card integrado do Apps Script.

Consulte Widgets para mais informações.

Função do gerenciador de widgets

Uma função que vincula um widget específico a um objeto de ação específico. Cada tipo de widget tem um conjunto de funções de gerenciador de widget definidas que podem ser usadas para se conectar a ações. As funções do manipulador de widgets definem que tipo de interação do usuário aciona a ação resultante e são um componente crucial da interatividade do widget.

Consulte Funções do gerenciador de widgets para mais informações.