Glossário

Os seguintes termos são usados nesta documentação.

Complemento de videoconferência da 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 se conectar. Por causa desse requisito, a maioria dos desenvolvedores nunca precisa criar um complemento de videoconferências do Google Agenda.

Consulte Complementos para videoconferências da Agenda para mais informações. Consulte também Fazer upgrade dos complementos publicados para saber como converter um complemento para videoconferências da Agenda em um complemento do Google Workspace.

Cartas

Uma única "página" da interface de um 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.

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 mostra um card, que é basicamente 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 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 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, a mensagem aberta no Gmail, o evento do Google Agenda que você está editando ou os 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 transmitido para a função de acionamento como um parâmetro.

Acionamento contextual

A prática de definir acionadores que são ativados quando o usuário entra em um contexto específico, como ao abrir uma conversa por e-mail no Gmail. Com o acionamento contextual, seu complemento pode fornecer uma interface relevante para o contexto. Os gatilhos contextuais são configurados no manifesto do projeto de script do complemento e, portanto, são um tipo de gatilho de manifesto.

Complementos do editor

O conjunto original de tipos de complementos que só permitia extensões do Google Docs, Planilhas, Formulários ou Apresentações. Os complementos do editor não são baseados em cards. Em vez disso, eles exigem que o desenvolvedor crie uma interface com 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 criado automaticamente quando as páginas iniciais são solicitadas, quando o complemento entra em contextos 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 acionamento ou função 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 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, do comportamento e dos detalhes de desenvolvimento usados para criar complementos do Gmail é idêntica aos detalhes usados para criar complementos do Google Workspace.

Consulte Complementos do Gmail para mais informações. Consulte também 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 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 está visualizando as conversas por e-mail no Gmail, mas não abriu nenhuma). 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 card integrado do Apps Script. Somente os complementos do Editor mais antigos são baseados em HTML.

Os gatilhos de visualização de link são acionados quando os usuários interagem com um URL de terceiros ou que não é do Google em um aplicativo host do Google, como o Google Docs. Com o acionamento da visualização do link, é possível 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 card de visualização. Os gatilhos de visualização de link são configurados no manifesto do projeto de script do complemento e, portanto, são um tipo de gatilho de manifesto.

Consulte Prévia 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 as informações do projeto necessárias para que o script seja 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 interface.

Gatilho de manifesto

Um gatilho definido no manifesto de um projeto, como um gatilho de página inicial ou contextual. Os gatilhos 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 de exibição.

Os gatilhos de manifesto são diferentes de outros gatilhos no Apps Script porque não são integrados (como gatilhos simples) e não podem ser criados de forma programática com o serviço de script do Apps Script (como gatilhos 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 por 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 em que 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 aplicativo do Google Workspace. Ao passar o cursor sobre um ícone, os usuários também podem visualizar mais conteúdo sobre o arquivo ou link. Por exemplo, quando os usuários passam o cursor sobre um ícone para uma apresentação do Google Slides, eles veem uma captura de tela de um slide, o proprietário da apresentação e se já visualizaram o conteúdo antes.

É possível configurar o complemento para usar smart chips e visualizar links de um serviço de terceiros ou que não seja do Google. Consulte Visualizações de links no Google Docs.

Gatilho

Uma condição e uma resposta automática a eventos definidas por um projeto ou complemento do Apps Script. Os acionadores são ativados quando o evento associado ocorre (por exemplo, quando um complemento é aberto) e fazem com que uma função especificada do Apps Script (a função de acionamento) 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 é mostrada. Apenas alguns tipos de eventos 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 ao acionamento de um gatilho.

Widget

Um elemento da interface, como um botão, um campo de texto ou uma caixa de seleção. Os cards são construídos com 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 de manipulador 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 manipulador de widget definidas que podem ser usadas para se conectar a ações. As funções de manipulador de widget 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 de manipulador de widget para mais informações.