Glossário

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Os termos a seguir são usados ao longo desta 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 que eles sejam conectados. Por isso, 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 saber como converter um complemento de videoconferência do Google Agenda em um complemento do Google Workspace.

Card

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

Consulte Cards para ver mais informações.

Com base em cartão

Um complemento com a 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). O complemento tem uma barra de ferramentas que identifica o complemento e exibe um cartão, essencialmente uma "quot;page" da IU do complemento".

Os complementos do Google Workspace são baseados em cartões.

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 do Agenda.

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

Solução de videoconferência

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

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

Contexto

O estado atual do aplicativo host. Por exemplo, a mensagem aberta no Gmail, o evento do Agenda que você está editando ou os arquivos do Drive selecionados fazem parte do contexto atual do aplicativo host. O contexto com outras informações é coletado em um objeto de evento que é transmitido para a função do acionador 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 ao abrir uma conversa de e-mail no Gmail. O acionamento contextual permite que seu complemento forneça uma IU relevante para esse contexto. Os acionadores contextuais são configurados no manifesto do script de complementos e, portanto, são um tipo de acionador de manifesto.

Complementos de editor

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

Consulte Complementos de editor para ver mais detalhes.

Objeto de evento

O objeto JSON criado automaticamente quando as páginas iniciais são solicitadas, quando o complemento entra em contextos aos quais ele precisa responder ou como resultado de interações do usuário com widgets na interface do complemento. Depois de criados, os objetos de eventos são transmitidos para uma função de gatilho ou de função de retorno de chamada especificada. O objetivo dos objetos de evento é transmitir informações do ambiente do lado do cliente do usuário (como as informações que ele inseriu nos widgets da interface dos complementos) para o código do lado do servidor dos complementos, que podem usar essas informações e retornar a resposta apropriada.

Consulte Objetos de evento para mais detalhes.

Complementos do Gmail

Um complemento que amplia somente o Gmail. Os complementos do Gmail são baseados em cartões. Muito da funcionalidade, do comportamento e dos detalhes de desenvolvimento usados para criar complementos do Gmail é idêntico 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 saber como converter um complemento do Gmail em um Complemento 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 o complemento exiba 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 um). Você define a aparência e o comportamento da página inicial dos complementos como qualquer outro cartão.

Consulte as páginas iniciais para mais informações.

Host ou aplicativo host

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

Baseada em HTML

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

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 os complementos podem estender e oferecer determinadas configurações de controle da IU.

Acionador de manifesto

Um acionador definido no manifesto do projeto, como um acionador da página inicial ou um acionador contextual. Os acionadores de manifesto são usados exclusivamente para criar e exibir novos cards quando a página inicial dos complementos é solicitada ou quando o complemento entra em um contexto que requer uma atualização da tela.

Os acionadores de manifesto são diferentes de 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 scripts 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 de e-mail no Gmail, mas não abriu uma. As páginas iniciais são um tipo de card não contextual.

A seção à direita da IU do host em que uma IU de complementos do Google Workspace aparece. Os complementos do Gmail e do editor também podem definir barras laterais.

Gatilho

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

Consulte Acionadores de complemento para mais informações.

Função acionador

Uma função do Apps Script em um projeto executado em resposta a um acionador que será disparado.

Widget

Um elemento da IU, como um botão, um campo de texto ou uma caixa de seleção. Os cartões são criados a partir de uma sequência de objetos de widget, definidos pelo serviço de cartões integrado ao Apps Script.

Consulte Widgets para mais informações.

Função do gerenciador de widgets

Uma função que vincula um determinado widget a um objeto de ação específico. Cada tipo de widget tem um conjunto de funções definidas de gerenciador de widget que podem ser usadas para se conectar a ações. As funções de mão de widget definem qual 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 widget para ver mais informações.