Há algumas restrições sobre o que os complementos podem fazer. Evite esses erros para melhorar a experiência geral dos usuários.
Restrições gerais
As restrições a seguir se aplicam a todos os complementos. Não faça o seguinte:
Alterar recursos no Google Workspace
O framework de complementos foi criado para aprimorar os aplicativos do Google Workspace, não para adicionar limites. Consequentemente, não é possível alterar os recursos existentes 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, você pode usar seu próprio sistema de pagamento ou fazer uma chamada para um banco de dados de faturamento. Seu complemento pode se conectar a serviços de terceiros que cobram dos usuários.
Detectar muitos eventos
Exceto em alguns gatilhos, os complementos não podem informar 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 detectar mudanças no conteúdo de um arquivo pelo 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 de cartão. Não faça o seguinte:
Ampliar todos os apps do Google Workspace
Os complementos do Google Workspace só podem ser usados para estender o Gmail, a Agenda, o Drive, os Documentos, as Planilhas e as Apresentações. No futuro, os complementos do Google Workspace poderão estender outros aplicativos do Google Workspace.
Acionamento contextual no Drive
Os complementos do Google Workspace só podem fornecer acionamentos contextuais para o Gmail ao ler ou escrever mensagens e no Agenda quando os eventos estão abertos. Ainda não há suporte para acionar contextualmente arquivos do Drive. Consulte 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 adquirir o documento atual. Consulte
práticas de desenvolvimento provisórias.
Usar HTML/CSS ou scripts do lado do cliente
Os complementos do Google Workspace precisam usar interfaces com base em cards. As interfaces HTML/CSS compatíveis com os complementos do Editor não podem ser usadas. 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 para computador e dispositivos móveis, sem que você precise criar uma interface para cada uma delas.
Suporte total para dispositivos móveis
Por enquanto, os complementos do Google Workspace funcionam em clientes da Web para computador. O acionamento contextual (ou seja, a leitura de mensagens do Gmail) também é aceito no 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 gatilhos 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.
Ter mais de 100 widgets
Por motivos de desempenho, não é possível adicionar mais de 100 widgets ou 100 seções de card a um card.