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ı öneririz.
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 hangi hesap olması gerektiğini ve hangi hesabın yayıncı olarak hareket etmesi 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 Google Cloud projesine erişebildiğinden emin olun.
Google Workspace'i kopyalamayın, genişletin
Eklentiler, kapsamını genişlettikleri Google Workspace uygulamalarına yeni özellikler sunmak veya karmaşık görevleri otomatikleştirmek için tasarlanmıştır. Uygulamada zaten bulunan işlevleri yalnızca kopyalayan veya iş akışında önemli iyileştirmeler yapmayan eklentilerin yayınlanmak için eklenti incelemesini 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, tüm Apps Komut Dosyası kodunun tek bir komut dosyası projesinde yer aldığı durumlardan daha yavaş çalışmasını sağlayabilir. Apps Komut Dosyası 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. Bu gecikmeye takılmadan jQuery gibi istemci tarafı JavaScript kitaplıklarını ö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 kapsamlı bir şekilde test edin
Eklentinizi test ederken farklı dosyalara ve farklı yetkilendirme durumlarına sahip yapılandırmaları denediğinizden emin olun.