Há algumas restrições sobre o que os complementos podem fazer. Melhore a experiência geral dos usuários evitando essas armadilhas.
Restrições gerais
As restrições a seguir se aplicam a todos os complementos. Não faça o seguinte:
Mudar recursos no Google Workspace
A estrutura de complementos foi criada para aprimorar os aplicativos do Google Workspace, não para adicionar limites. Consequentemente, não é possível alterar os recursos atuais nem bloquear o modelo de compartilhamento de documentos do Google Workspace.
Cobrar dos usuários para instalar
Não oferecemos uma maneira de cobrar dos usuários pela instalação de complementos, e os complementos não podem incluir anúncios. No entanto, é possível criar seu próprio sistema de pagamento ou chamar um banco de dados de faturamento atual. O complemento pode se conectar a serviços que não são do Google e que cobram dos usuários.
Detectar muitos eventos
Exceto por alguns acionadores, os complementos não podem dizer o que um usuário faz fora do próprio complemento. Por exemplo, não é possível detectar quando o usuário clica na barra de ferramentas do aplicativo host. É possível pesquisar mudanças no conteúdo de um arquivo no código do lado do cliente de uma barra lateral, embora sempre haja um pequeno atraso.
Complementos do Google Workspace
As restrições a seguir se aplicam apenas aos complementos do Google Workspace e ao uso do serviço Card. Não faça o seguinte:
Estender todos os apps do Google Workspace
Os complementos do Google Workspace só podem estender o Gmail, o Agenda, o Drive, o Meet, o Documentos, o Planilhas e o Apresentações. Com o tempo, os complementos do Google Workspace poderão estender outros aplicativos do Google Workspace.
Contexto do documento nos editores
Os complementos do Google Workspace ainda não oferecem suporte ao uso do contexto do documento nos editores. Ou seja, não é possível usar métodos como
SpreadsheetApp.getActiveSpreadsheet()
para adquirir o documento atual.
Usar HTML/CSS ou linguagem de cliente
Os complementos do Google Workspace precisam usar interfaces baseadas em cards. Não é possível usar as interfaces HTML/CSS com suporte a complementos do Editor. Os complementos do Google Workspace usam uma abordagem baseada em widgets para criar interfaces do usuário. Isso permite que o complemento funcione bem em plataformas de computadores e dispositivos móveis sem que você precise criar uma interface para cada uma delas.
Suporte completo para dispositivos móveis
No momento, os complementos do Google Workspace funcionam em clientes da Web para computadores. O acionamento contextual (ou seja, a leitura de mensagens do Gmail) também é compatível com o app Gmail para dispositivos móveis. As páginas iniciais não contextuais ainda não estão disponíveis nos apps Gmail, Agenda ou Drive para dispositivos móveis. Os complementos do Google Workspace não estão disponíveis em navegadores da Web para dispositivos móveis.
Usar acionadores do Apps Script
Não é possível criar ou usar acionadores simples do Apps Script em um complemento do Google Workspace.
Usar imagens SVG
No momento, não é possível usar imagens SVG com cards do serviço Card e widgets.
Ter mais de 100 widgets
Por motivos de desempenho, não é possível adicionar mais de 100 widgets ou 100 seções de cards a um card.