Glossário

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

Complemento de videoconferência do Google Agenda

Um tipo especial de complemento usado para permitir que 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 Google 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 Google Agenda em um complemento do Google Workspace.

Card

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

Consulte Cards para mais informações.

Com base no cartão

Um complemento em que a 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 cartão, essencialmente uma "página" da IU 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 videoconferências de terceiros possibilitadas por um complemento do Google Workspace ou do Agenda.

Consulte Dados da videoconferê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 os complementos do Google Workspace ou do Agenda.

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

Contexto

O estado atual do aplicativo host. Por exemplo, qual 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 e outras informações são coletados em um objeto de evento que é transmitido para a função do acionador como um parâmetro.

Acionamento contextual

A prática de definir acionadores que são disparados 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 seu complemento forneça uma IU 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ó permitiam extensões de arquivos 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 IU usando HTML e CSS brutos. Cada complemento de editor só pode estender um aplicativo host.

Consulte Complementos do editor para mais detalhes.

Objeto de evento

O objeto JSON criado automaticamente quando as páginas iniciais são solicitadas, quando o complemento entra em contextos a que 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 gatilho ou uma função de callback específica. A finalidade dos objetos de evento é transmitir informações do ambiente do lado do cliente do usuário (por exemplo, informações inseridas nos widgets de interface do complemento) para o código do lado do servidor do complemento, que pode 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 amplia apenas o Gmail. Os complementos do Gmail são baseados em cartões. Muitos dos detalhes de funcionalidade, comportamento e desenvolvimento usados para criar complementos do Gmail são idênticos aos mesmos 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 card da IU raiz de um complemento. As páginas iniciais aparecem quando os usuários abrem o complemento e permitem que o complemento mostre conteúdo fora de um contexto específico (por exemplo, quando o usuário vê as conversas de e-mail no Gmail, mas não abriu uma). Defina a aparência e o comportamento da página inicial do complemento como qualquer outro card.

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

Aplicativo host ou host

O aplicativo do Google Workspace que um complemento do Google Workspace estenda, 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 Card integrado ao Apps Script. Somente complementos do editor mais antigos são baseados em HTML.

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

Consulte Visualizar links no Documentos Google 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 da IU.

Gatilho do 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 requer uma atualização de exibição.

Os acionadores do manifesto são diferentes dos outros no Apps Script porque não são integrados (como gatilhos simples) e não podem ser criados programaticamente 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 de e-mail no Gmail, mas não abrir nenhuma. As páginas iniciais são um tipo de card não contextual.

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

Ícone inteligente

Um ícone inteligente é a menção de 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 conteúdo adicional sobre o arquivo ou o link. Por exemplo, quando os usuários passarem o cursor sobre um ícone para uma apresentação do Apresentações Google, eles verão a captura de tela do slide, o proprietário da apresentação e se já visualizaram a apresentação antes.

É possível configurar seu complemento para usar ícones inteligentes e 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 de evento definidas por um projeto ou complemento do Apps Script. Os gatilhos são disparados 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 acionamento geralmente criam novos cards para controlar qual parte da IU do complemento é exibida. Apenas determinados tipos de evento podem ter acionadores.

Consulte acionadores de complementos para mais informações.

Função de gatilho

Uma função do Apps Script em um projeto que é executada em resposta ao disparo de um acionador.

Widget

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