Melhore a experiência geral dos usuários seguindo estes guias de design de complementos.
Práticas recomendadas gerais
Recomendamos que você use as práticas recomendadas a seguir para todos os complementos que desenvolver.
Determine a propriedade do complemento antes de começar
Os complementos são definidos por projetos do Apps Script, que precisam ser de propriedade de uma conta específica ou colocados em um drive compartilhado. Antes de programar um complemento, determine qual conta será proprietária do projeto e qual conta atuará como publisher. Determine também quais contas vão atuar como colaboradores e verifique se elas têm acesso ao projeto de script e ao projeto na nuvem do Google Cloud associado.
Amplie o Google Workspace, não o replique
Os complementos são destinados a oferecer novos recursos aos aplicativos do Google Workspace que eles ampliam ou automatizar tarefas complexas. Os complementos que apenas replicam funcionalidades já presentes no aplicativo ou que não fazem melhorias significativas em um fluxo de trabalho provavelmente não vão passar pela análise de complementos para publicação.
Mantenha os escopos restritos
Ao definir seus escopos
explicitamente, sempre escolha o
conjunto de escopos menos permissivo possível. Por exemplo, não faça com que seu complemento solicite acesso total à agenda do usuário com o escopo https://www.googleapis.com/auth/calendar se ele só precisar de acesso de leitura. Para acesso somente leitura, use o escopo https://www.googleapis.com/auth/calendar.readonly.
Evite depender muito de bibliotecas
O uso de bibliotecas do Apps Script pode fazer com que o complemento seja executado mais lentamente do que se todo o código do Apps Script estivesse contido em um único projeto de script. Embora as bibliotecas do Apps Script funcionem em complementos, você pode ter reduções de desempenho se as usar. Evite incluir bibliotecas desnecessárias no seu projeto e considere maneiras de reduzir a dependência do complemento delas.
A latência descrita acima se aplica apenas a projetos do Apps Script usados como bibliotecas do lado do servidor. Você pode usar bibliotecas JavaScript do lado do cliente, como o jQuery, livremente sem encontrar essa latência.
Práticas recomendadas para complementos do Editor
As práticas recomendadas a seguir se aplicam apenas ao complemento do Editor.
Coloque o HTML da interface e o JavaScript do lado do cliente em arquivos de script próprios
É possível criar vários arquivos de script em um projeto do Apps Script. É mais fácil gerenciar um complemento complexo se você colocar o HTML e o JavaScript que definem as barras laterais e as caixas de diálogo do complemento em arquivos de script dedicados a eles.
Teste completamente em diferentes modos de autorização
Ao testar o complemento, tente configurações com arquivos e estados de autorização diferentes.