Eklenti tasarımıyla ilgili bu kılavuzları uygulayarak 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ı kullanmanız önerilir.
Başlamadan önce eklenti sahipliğini belirleme
Eklentiler, belirli bir hesaba ait olması veya ortak drive'a yerleştirilmesi gereken Apps Komut Dosyası projeleriyle tanımlanır. Bir eklentiyi kodlamadan önce projeye hangi hesabın sahip olması gerektiğini ve hangi hesabın yayıncı olarak hareket edeceğini belirleyin. Ayrıca hangi hesapların ortak çalışan olarak hareket edeceğini belirleyin ve bu hesapların komut dosyası projesine ve ilişkili Google Cloud projesine erişebildiğinden emin olun.
Google Workspace'in kapsamını genişletin, kopyalamayın
Eklentiler, kapsamlarını genişlettikleri Google Workspace uygulamalarına yeni özellikler sağlamak veya karmaşık görevleri otomatikleştirmek için tasarlanmıştır. Yalnızca uygulamada bulunan işlevleri kopyalayan veya iş akışında önemli iyileştirmeler yapmayan eklentilerin yayınlanmak üzere eklenti incelemesini geçmesi olası değildir.
Kapsamları dar tutun
Kapsamlarınızı açıkça tanımlarken her zaman mümkün olan en az izin veren kapsam kümesini seçin. Örneğin, eklentinizin yalnızca okuma erişimine ihtiyacı varsa https://www.googleapis.com/auth/calendar kapsamıyla kullanıcının Takvimine tam erişim istemeyin. Salt okuma erişimi için https://www.googleapis.com/auth/calendar.readonly kapsamını kullanın.
Kütüphanelere çok fazla güvenmeyin
Apps Komut Dosyası kitaplıklarını kullanmak, tüm Apps Komut Dosyası kodu tek bir komut dosyası projesinde yer alsaydı eklentinizin daha yavaş çalışmasına neden olabilir. Apps Komut Dosyası kitaplıkları eklentilerde çalışsa da bunları kullanırsanız performans düşüşleri yaşayabilirsiniz. Projenize gereksiz kitaplıklar eklemekten kaçının ve eklentinizin bu kitaplıklara olan bağımlılığını azaltmanın yollarını düşünün.
Yukarıda açıklanan gecikme yalnızca sunucu tarafı kitaplıkları olarak kullanılan Apps Komut Dosyası projeleri için geçerlidir. Bu gecikmeyle karşılaşmadan jQuery gibi istemci tarafı JavaScript kitaplıklarını serbestçe kullanabilirsiniz.
Düzenleyici eklentisiyle ilgili en iyi uygulamalar
Aşağıdaki en iyi uygulamalar yalnızca Düzenleyici eklentisi için geçerlidir.
Arayüz HTML'sini ve istemci tarafı JavaScript'i kendi komut dosyalarına yerleştirin.
Bir Apps Komut Dosyası projesinde birden fazla komut dosyası oluşturabilirsiniz. Eklenti kenar çubuklarını ve iletişim kutularını tanımlayan HTML ve JavaScript'i kendilerine ayrılmış komut dosyalarına yerleştirirseniz karmaşık bir eklentiyi yönetmek daha kolay olur.
Farklı yetkilendirme modlarında kapsamlı bir şekilde test edin
Eklentinizi test ederken farklı dosyalar ve farklı yetkilendirme durumlarına sahip yapılandırmaları denediğinizden emin olun.