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 uygulamalardan yararlanmanız önerilir.
Başlamadan önce eklenti sahipliğini belirleyin
eklentiler, belirli bir hesaba ait olması veya ortak Drive'a yerleştirilmesi gereken Apps Komut Dosyası projeleri tarafından tanımlanır. Eklenti kodlamadan önce projenin sahibinin ve yayıncısının hangi hesap olması gerektiğini belirleyin. Ayrıca hangi hesapların ortak çalışan olarak görev yapacağını belirleyin ve bu hesapların komut dosyası projesine ve ilişkili Cloud Platform projesine erişebildiğinden emin olun.
Google Workspace'i kopyalamayın, genişletin
Eklentiler, genişlettikleri Google Workspace uygulamalarına yeni özellikler sunmak veya karmaşık görevleri otomatikleştirmek için tasarlanmıştır. Uygulamadaki işlevleri yalnızca kopyalayan veya iş akışında önemli iyileştirmeler yapmayan eklentilerin yayınlanmak üzere eklenti incelemesinden geçme olasılığı düşüktür.
Kapsamları dar tutun
Kapsamlarınızı açıkça tanımlarken her zaman mümkün olan en az izin veren kapsam grubunu seçin. Örneğin, yalnızca okuma erişimine ihtiyacı varsa eklentinizin https://www.googleapis.com/auth/calendar kapsamıyla kullanıcının Takvim'ine tam erişim isteğinde bulunmasına izin 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 tüm Apps Komut Dosyası kodunun tek bir komut dosyası projesinde yer alması durumunda olduğundan daha yavaş çalışmasına neden olabilir. Apps Script kitaplıkları eklentilerde çalışsa da bunları kullanırsanız performansta düşüşler görebilirsiniz. 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. jQuery gibi istemci tarafı JavaScript kitaplıklarını bu gecikmeye takılmadan özgürce kullanabilirsiniz.
Düzenleyici eklentisi ile 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 dosyası dosyalarına yerleştirin
Apps Komut Dosyası projelerinde birden fazla komut dosyası dosyası oluşturabilirsiniz. Eklenti kenar çubuklarını ve iletişim kutularını tanımlayan HTML ile JavaScript'i, bunlara özel komut dosyası dosyalarına yerleştirirseniz karmaşık bir eklentiyi yönetmek daha kolay olur.
Farklı yetkilendirme modlarında ayrıntılı olarak test edin
Eklentinizi test ederken farklı dosyalara ve farklı yetkilendirme durumlarına sahip yapılandırmaları denediğinizden emin olun.