Os complementos têm algumas restrições. Melhore a experiência geral dos usuários evitando essas armadilhas.
Restrições gerais
As restrições abaixo se aplicam a todos os complementos. Não faça o seguinte:
Mudar recursos no Google Workspace
O framework de complementos foi projetado para melhorar os aplicativos do Google Workspace, não para adicionar limites. Consequentemente, não é possível alterar os recursos atuais ou bloquear o modelo de compartilhamento de documentos do Google Workspace.
Cobrar os usuários com a instalação
Não oferecemos uma maneira de cobrar os usuários pela instalação de complementos, e os complementos não podem incluir anúncios. No entanto, é possível implementar seu próprio sistema de pagamento ou chamar um banco de dados de faturamento existente. Seu complemento pode se conectar a serviços que não são do Google e que cobram os usuários.
Detectar vários eventos
Com exceção de determinados acionadores, os complementos não conseguem identificar o que um usuário faz fora do 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 usando o código de uma barra lateral do lado do cliente, 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 de cartões. Não faça o seguinte:
Ampliar todos os apps do Google Workspace
Os complementos do Google Workspace só podem estender o Gmail, Agenda, Drive, Documentos, Planilhas e Apresentações. Com o tempo, os complementos do Google Workspace poderão estender outros aplicativos do Google Workspace.
Acionamento contextual no Drive
Os complementos do Google Workspace só oferecem acionamento contextual para o Gmail ao ler ou escrever mensagens e no Agenda quando os eventos estão abertos. Ainda não é possível acionar o acionamento contextual para os arquivos do Drive. Consulte as práticas de desenvolvimento provisórias.
Contexto do documento nos Editores
Os complementos do Google Workspace ainda não oferecem suporte ao uso do
contexto do documento em editores. Ou seja, não é possível usar métodos como
SpreadsheetApp.getActiveSpreadsheet()
para conseguir o documento atual. Consulte as
práticas de desenvolvimento provisórias.
Usar HTML/CSS ou script do lado do cliente
Os complementos do Google Workspace precisam usar interfaces baseadas em cartão. Não é possível usar as interfaces HTML/CSS com suporte aos complementos do Editor. Os complementos do Google Workspace usam uma abordagem baseada em widget para criar interfaces do usuário. Isso permite que o complemento funcione bem em plataformas para computadores e dispositivos móveis, sem a necessidade de criar uma interface para cada uma.
Suporte completo para dispositivos móveis
Por enquanto, 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 está disponível no app Gmail para dispositivos móveis. 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 e widgets do serviço de cards.
Têm 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.