Restrições

Há algumas restrições sobre o que os complementos podem fazer. Para evitar problemas, melhore a experiência geral dos usuários.

Restrições gerais

As restrições a seguir são válidas para todos os complementos. Não faça o seguinte:

Mudar recursos no Google Workspace

A estrutura de complementos foi projetada para melhorar os aplicativos do Google Workspace, e não adicionar limites. Portanto, não é possível alterar os recursos atuais nem bloquear o modelo de compartilhamento de documentos do Google Workspace.

Cobrar os usuários para instalar

Não fornecemos uma maneira de cobrar os usuários pela instalação de complementos, e eles não podem incluir anúncios. No entanto, é possível implementar seu próprio sistema de pagamento ou chamar em um banco de dados de faturamento existente. Seu complemento pode se conectar a serviços que não são do Google e faturam aos usuários.

Detectar vários eventos

Exceto para determinados acionadores, não é possível informar 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 usando o 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 só se aplicam aos Complementos do Google Workspace e ao uso do serviço de cartões. 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 Documentos, o Planilhas e o 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 o acionamento contextual para o Gmail ao ler ou escrever mensagens e no Agenda quando os eventos estão abertos. O acionamento contextual de arquivos do Drive ainda não está disponível. Consulte Práticas de desenvolvimento temporárias.

Contexto do documento nos editores

Os complementos do Google Workspace ainda não oferecem suporte ao uso de contexto de documentos em editores. Ou seja, não é possível usar métodos como SpreadsheetApp.getActiveSpreadsheet() para adquirir o documento atual. Consulte Práticas de desenvolvimento temporárias.

Usar HTML/CSS ou scripts do lado do cliente

Os complementos do Google Workspace precisam usar interfaces baseadas em cartões. Não é possível usar as interfaces HTML/CSS compatíveis com os 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 computadores e plataformas móveis, sem exigir que você crie uma interface para cada um.

Compatibilidade total com dispositivos móveis

Por enquanto, os complementos do Google Workspace funcionam nos 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. Páginas iniciais não contextuais ainda não estão disponíveis nos apps Gmail, Agenda ou Drive. Os complementos do Google Workspace não estão disponíveis em navegadores da Web para dispositivos móveis.

Usar gatilhos 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 cartões e widgets do Serviço de cartão.

Ter mais de cem widgets

Por motivos de desempenho, não é possível adicionar mais de 100 widgets ou 100 seções de cartão a um cartão.