Glossário

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

Complemento de videoconferência do 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 videoconferência bem desenvolvida para conexão. Devido a esse requisito, a maioria dos desenvolvedores nunca precisa criar um complemento de videoconferência do Agenda.

Consulte Complementos de videoconferência do Agenda para mais informações. Consulte também Como fazer upgrade dos complementos publicados para informações sobre como converter um complemento de videoconferência do Agenda em um Complemento do Google Workspace.

Card

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

Consulte Cards para mais informações.

Baseado em cartão

Um complemento com interface do usuário que aparece como um painel na barra lateral (ou, em dispositivos móveis, como outra janela de atividade acessada pelo menu). Ele tem uma barra de ferramentas na parte de cima que identifica o complemento e exibe um card, que é essencialmente uma "página" da interface do complemento.

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

Dados da videoconferência

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

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

Solução de conferência

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

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

Contexto

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

Acionamento contextual

A prática de definir gatilhos que são disparados quando o usuário insere 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 de script de complemento e, portanto, são um tipo de acionador de manifesto.

Complementos do editor

O conjunto original de tipos de complementos que só permitia extensões do Documentos, Planilhas, Formulários ou Apresentações Google. Os complementos do editor não são baseados em cards. Na verdade, eles exigiam que o desenvolvedor criasse 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 insere contextos aos quais precisa responder ou como resultado de 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 acionamento ou de callback 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 de complementos) para o código do lado do servidor do complemento, que pode então agir de acordo com essas 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 os 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 Como fazer upgrade dos complementos publicados para informações sobre como converter um Complemento do Gmail em um Complemento do Google Workspace.

Página inicial

O cartão da interface 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 visualiza as conversas de e-mail no Gmail, mas não abriu uma). Você define a aparência e o comportamento da página inicial do complemento como qualquer outro cartão.

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

Aplicativo host ou host

O aplicativo do Google Workspace é estendido para um complemento do Google Workspace, como o Gmail ou o Google Agenda.

Baseado em HTML

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

A visualização do 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 app Documentos. O acionamento da visualização de link permite definir padrões de URL para visualizar do seu serviço ou API e configurar o conteúdo da visualização, incluindo o ícone inteligente e o cartão de visualização. Os acionadores da visualização do link são configurados no manifesto do projeto de script de complemento e, portanto, são um tipo de acionador do manifesto.

Consulte Visualizar links com ícones inteligentes para mais informações.

Manifesto

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

Gatilho 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 quando o complemento entra em um contexto que exige uma atualização da tela.

Os acionadores de manifesto são diferentes dos outros no Apps Script porque não são integrados (como acionadores simples) e não podem ser criados de forma programática com o serviço do 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, ao visualizar as conversas no Gmail, mas não ter aberto um. As páginas iniciais são um tipo de card não contextual.

A seção à direita da interface do host em que é exibida a interface de um complemento do Google Workspace. Os complementos do Gmail e dos Editores também podem definir barras laterais.

Ícone inteligente

Um ícone inteligente é uma referência a uma pessoa, um arquivo, um evento da agenda ou outra entidade em um aplicativo do Google Workspace. Quando os usuários passam o cursor sobre um ícone, eles também podem visualizar mais conteúdo sobre o arquivo ou link. Por exemplo, quando os usuários passam o cursor sobre um ícone de uma apresentação Google, eles veem a captura de tela de um slide, o proprietário da apresentação e se ela já foi visualizada.

É possível configurar seu complemento para usar ícones inteligentes para visualizar links de um serviço de terceiros ou de terceiros. Consulte Visualizar links no Documentos Google.

Gatilho

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

Consulte Acionadores de complementos para mais informações.

Função de gatilho

Uma função do Apps Script em um projeto, executada em resposta a um acionador acionado.

Widget

Um elemento da interface, como um botão, um campo de texto ou uma caixa de seleção. Os cards são criados com base em uma sequência de objetos de widget definidos pelo serviço de cards 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 determinado objeto de ação. Cada tipo de widget tem um conjunto definido de funções de gerenciador de widgets que pode ser usado para se conectar a ações. As funções do gerenciador 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.