Glossário

Os termos a seguir são usados ao longo desta documentação.

Complemento de videoconferência do Agenda

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

Consulte Complementos de videoconferência do Agenda para mais informações. Consulte também Como fazer upgrade dos complementos publicados para ver 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 IU de 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 cartão

Um complemento cuja interface do usuário aparece como um painel na barra lateral (ou, em dispositivos móveis, como outra janela de atividades alcançada pelo menu). O complemento tem uma barra de ferramentas na parte superior que identifica o complemento e exibe um cartão, basicamente uma "página" 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 videoconferências de terceiros ativadas por um complemento do Google Workspace ou do Google Agenda.

Consulte Dados de videoconferê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 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 está aberta no Gmail, qual evento da Agenda você está editando ou quais arquivos do Drive você selecionou como parte do contexto atual do aplicativo host. O contexto e outras informações são coletados em um objeto de evento transmitido para a função de gatilho 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 por e-mail no Gmail. O acionador 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 complementos e são um tipo de acionador de manifesto.

Complementos de editor

O conjunto original de tipos de complementos que só permitiam extensões do 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 com CSS e HTML bruto. Cada complemento do editor pode estender apenas um aplicativo host.

Veja mais detalhes em Complementos do Editor.

Objeto de evento

O objeto JSON criado automaticamente quando as páginas iniciais são solicitadas, quando o complemento entra em 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 gatilho ou função de callback especificada. A finalidade dos objetos de evento é transmitir informações do ambiente do lado do cliente do usuário (como as informações inseridas nos widgets da interface do complemento) para o código do lado do servidor do complemento, que pode trabalhar com essas informações e retornar a resposta apropriada.

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 cards. 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 ver 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 são exibidas 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 está vendo as conversas de e-mail no Gmail, mas não abriu. 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 complemento do Google Workspace que inclui um complemento, como o Gmail ou o Google Agenda.

Com base em HTML

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

Os acionadores de visualização de link são disparados quando os usuários interagem com um URL de terceiros ou de terceiros em um aplicativo host do Google, como o Documentos Google. Com o acionador de visualização de link, você define padrões de URL para visualização no seu serviço ou na API e configura o conteúdo, incluindo o chip inteligente e o card de visualização. Os acionadores de visualização de links são configurados no manifesto do projeto de script de complementos e, portanto, são um tipo de acionador de manifesto.

Consulte Visualizar links no Documentos Google para saber mais.

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. Nos complementos do Google Workspace, o manifesto é usado para especificar quais hosts podem ser estendidos e fornecer determinadas configurações de controle de IU.

Acionador do manifesto

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

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 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, na visualização das linhas de execução do e-mail no Gmail, mas não abriu um. 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 aparece. Os complementos do Gmail e do Editor 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, também podem visualizar mais conteúdo sobre o arquivo ou link. Por exemplo, quando os usuários passam o cursor sobre um ícone em um arquivo do Apresentações Google, veem uma captura de tela de um slide, o proprietário da apresentação e se já visualizaram a apresentação.

É 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 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, que é a função de gatilho, seja executada automaticamente. Para os complementos do Google Workspace, as funções de gatilho costumam criar novos cards para controlar qual parte da IU dos complementos é exibida. Apenas determinados tipos de evento podem ter acionadores.

Consulte acionadores de complementos para mais informações.

Acionar função

Uma função do Apps Script em um projeto que é executada em resposta a um acionador que está sendo disparado.

Widget

Um elemento da IU, como um botão, campo de texto ou caixa de seleção. Os cartões são criados com base em uma sequência de objetos de widget, definida pelo serviço de cartões integrado do Apps Script.

Consulte Widgets para mais informações.

Função de gerenciador de widget

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 ele pode usar para se conectar a ações. Elas 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.