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.
Google Workspace eklentileri ile ilgili en iyi uygulamalar
Aşağıdaki en iyi uygulamalar yalnızca Google Workspace eklentileri ve Kart hizmeti'nin kullanımı için geçerlidir.
Yalnızca birkaç kart kullanın
Eklenti çok fazla kart kullanıyorsa gezinme yapılandırması karmaşık hale gelir ve yönetimi zorlaşır.
Gerekenden fazla kart oluşturma dürtüsünden kaçının.
Widget oluşturma işlevlerini kullanma
Card veya diğer karmaşık kullanıcı arayüzü nesnelerini oluşturan kod yazarken bu kodu kendi işlevine koymayı düşünebilirsiniz. Bu oluşturma işlevi, nesneyi oluşturup döndürmelidir. Bu sayede, kullanıcı arayüzünün yenilenmesi gerektiğinde söz konusu nesneyi hızlıca yeniden oluşturabilirsiniz. Kart hizmetindeki oluşturucu sınıflarını kullandıktan sonra build() işlevini çağırmayı unutmayın.
Kartları basit tutun
Belirli bir kartta çok fazla widget varsa ekranın büyük bir kısmını kaplayarak daha az kullanışlı hale gelebilir. Büyük kart bölümleri, daraltılabilir kullanıcı arayüzü öğeleri olarak oluşturulur. Bu, bilgileri kullanıcıdan gizler. Eklentinizi basitleştirmeyi ve kullanıcının tam olarak ihtiyaç duyduğu şeyi sunmayı hedefleyin.
Hata kartlarını kullanma
Hata koşulları için kartlar oluşturun. Eklentiniz hata oluşturuyorsa hata bilgilerini ve mümkünse hatayı düzeltme talimatlarını içeren bir kart gösterilir. Örneğin, eklentiniz provizyon başarısız olduğu için Google dışı bir hizmete bağlanamadıysa bunu belirten bir kart gösterin ve kullanıcıdan kullanılan hesap bilgilerini doğrulamasını isteyin.
Testler ve test mesajları yazma
Oluşturduğunuz tüm eklentileri ayrıntılı olarak test etmeniz gerekir. Test verileri kullanarak kart ve widget oluşturan test işlevleri oluşturun ve ardından nesnelerin beklendiği gibi oluşturulduğunu doğrulayın.
İşlem geri çağırma işlevlerini kullanırken genellikle bir yanıt nesnesi oluşturmanız gerekir. Yanıtların doğru şekilde oluşturulduğunu doğrulamak için aşağıdaki gibi ifadeler kullanabilirsiniz:
Logger.log(response.printJson());
Oluşturduğunuz test işlevlerini doğrudan Apps Script düzenleyicisinden Çalıştır menüsünü kullanarak çalıştırın. Çalışan uygun bir eklentiniz olduğunda, test edebilmek için yayınlanmamış sürümü yüklediğinizden emin olun.
Eklentinin genişlettiği her ana uygulama için uygun test verilerini kullanın. Örneğin, eklenti Gmail'i genişletiyorsa farklı ileti içerikleri kullanıldığında eklentinin beklendiği gibi çalıştığından emin olmak için birkaç test e-postasına ve bunların ileti kimliklerine ihtiyacınız olabilir. Belirli bir ileti için ileti kimliğini, Gmail APIusers.messages.list yöntemini kullanarak veya Apps Script'in Gmail hizmetini kullanarak iletileri listeleyerek alabilirsiniz.
Takvimde konferans görüşmesi yapmayla ilgili en iyi uygulamalar
Eklentiniz Google Takvim'e üçüncü taraf takvim konferansı seçenekleri entegre ediyorsa aşağıdaki en iyi uygulamaları uygulayın:
onCreateFunction ışığını açık tutun
Manifestinizde tanımladığınız her onCreateFunction, bir kullanıcı bu tür bir konferans çözümü oluşturmaya çalıştığında eşzamanlı olarak çağrılır. Bu işlevlerin yalnızca konferansı oluşturmak için gereken minimum işlemi yaptığından emin olun. Bu işlevlerde çok fazla işlem yapmak, eklentinizin yavaş bir kullanıcı deneyimi sunmasına neden olabilir.
Konferans verileri için uygun ConferenceData alanlarını kullanın
ConferenceData objeleri oluşturduğunuzda bunları konferansla ilgili ayrıntılarla (erişim kodları, telefon numaraları, iğneler, URI'ler vb.) doldurabilirsiniz. Bu bilgiler için ilgili EntryPoint alanını kullandığınızdan emin olun. Bu ayrıntıları ConferenceData notlar alanına yerleştirmeyin.
Konferans görüşmesi ayrıntılarını Takvim etkinliğine ekleme
Eklentinizin, oluşturulan üçüncü taraf konferanslarla ilgili bilgileri Takvim etkinlik açıklamasına eklemesi gerekmez. Takvim, gerektiğinde bunu otomatik olarak yapar.