Eklenti tasarımıyla ilgili bu kılavuzları izleyerek kullanıcılarınızın genel deneyimini iyileştirin.
Genel en iyi uygulamalar
Geliştirdiğiniz tüm eklentiler için aşağıdaki en iyi uygulamaları izlemenizi öneririz.
Başlamadan önce eklenti sahipliğini belirleyin
Eklentiler, belirli bir hesaba ait olması veya bir ortak Drive'a yerleştirilmiş olması gereken Apps Komut Dosyası projeleri tarafından tanımlanır. Bir eklentiyi kodlamadan önce, projeye hangi hesabın sahip olması gerektiğini ve hangi hesabın yayıncısı olarak görev yapacağını belirleyin. Ayrıca, ortak çalışan olarak kullanılacak hesapları belirleyin ve bu hesapların, komut dosyası projesine ve ilişkili Cloud platform projesine erişimi olduğundan emin olun.
Google Workspace'in kapsamını genişletip çoğaltmayın
Eklentilerin, genişlettikleri Google Workspace uygulamalarına yeni özellikler sağlaması veya karmaşık görevleri otomatikleştirmeleri amaçlanmıştır. Yalnızca uygulamanın içinde bulunan işlevleri çoğaltan veya bir iş akışında aynı önemli iyileştirmeleri yapmayan eklentilerin, yayınlanmak üzere eklenti incelemesinden geçmeleri pek olası değildir.
Kapsamları dar tutun
Kapsamlarınızı açık bir şekilde tanımlarken her zaman mümkün olan en dar kapsamlı kapsam grubunu seçin. Örneğin, eklenti isteğinizin yalnızca okuma erişimine ihtiyacı varsa https://www.googleapis.com/auth/calendar kapsamıyla kullanıcının Takvimine tam erişimi vermeyin. Salt okuma erişimi için https://www.googleapis.com/auth/calendar.readonly kapsamını kullanın.
Kitaplıklara çok fazla güvenmekten kaçının
Apps Komut Dosyası kitaplıklarını kullanmak, eklentinizin, Apps Komut Dosyası kodunun tamamı tek bir komut dosyası projesinde yer aldığında, gerekenden daha yavaş çalışmasına neden olabilir. Apps Komut Dosyası kitaplıkları eklentilerde çalışır ancak bunları kullanırsanız performans düşüşleriyle karşılaşabilirsiniz. Projenize gereksiz kitaplıklar eklemekten kaçının ve eklentinizin bu kitaplıklara bağımlılığını azaltmanın yollarını düşünün.
Yukarıda açıklanan gecikme, yalnızca sunucu tarafı kitaplık olarak kullanılan Apps Komut Dosyası projeleri için geçerlidir. Bu gecikmeyle karşılaşmadan jQuery gibi istemci taraflı JavaScript kitaplıklarını serbest bir şekilde kullanabilirsiniz.
Düzenleyici eklentisi için en iyi uygulamalar
Aşağıdaki en iyi uygulamalar yalnızca Editor eklentisi için geçerlidir.}.
Arayüz HTML'sini ve istemci tarafı JavaScript'i kendi komut dosyası dosyalarına yerleştirme
Bir Apps Komut Dosyası projesinde birden fazla komut dosyası dosyası oluşturabilirsiniz. Eklenti kenar çubuklarını ve iletişim kutularını tanımlayan HTML ve JavaScript'i, ilgili komut dosyası dosyalarına yerleştirirseniz karmaşık bir eklentiyi daha kolay yönetebilirsiniz.
Farklı yetkilendirme modlarını kullanarak kapsamlı testler yapın
Eklentinizi test ederken farklı dosyalara ve farklı yetkilendirme durumlarına sahip yapılandırmaları denediğinizden emin olun.