Kullanıcılarınızın aşağıdaki eklenti rehberlerini izleyerek genel deneyiminize tasarım.
Genel en iyi uygulamalar
Yüklediğiniz tüm eklentiler için aşağıdaki en iyi uygulamaları için de geçerlidir.
Başlamadan önce eklenti sahipliğini belirleyin
Eklentiler, Apps Komut Dosyası projelerine göre tanımlanır. Bu projelerin, sahip olması gereken belirli bir bir ortak drive'a yerleştirilmiş olan bir öğe varsa veya başka bir hesaba yerleştirilmişse. Eklentiyi kodlamadan önce projeye hangi hesabın sahip olması gerektiğini belirleyin ve hangi hesabın yayıncısı olduğunu görebilir. Hangi hesaplara işlem yapılacağını da belirleyin ortak çalışan olarak oturum açın ve bu hesapların komut dosyasına erişebildiğinden emin olun ve projeyle bağlantılı Cloud Platform projesi.
Google Workspace'in kapsamını artırın, kopyalamayın
eklentileri, kullanıcılara yeni özellikler sunmayı amaçlar. Uzattıkları Google Workspace uygulamalarını veya karmaşık görevleri otomatikleştirmenize yardımcı olur. yalnızca içinde halihazırda bulunan işlevleri kopyalayan önemli iyileştirmeler yapmayan uygulamalar için iş akışının eklenti incelemesinden geçme olasılığı düşük olan yayın.
Kapsamları dar tutun
Kapsamlarınızı açık bir şekilde tanımlarken
her zaman mümkün olan en dar kapsamlı izin kapsamlarını seçin. Örneğin,
eklenti isteğinizin kullanıcının Takvim'ine tam erişim için
Yalnızca okunması gerekiyorsa https://www.googleapis.com/auth/calendar kapsamı
erişim. Salt okuma erişimi için
https://www.googleapis.com/auth/calendar.readonly kapsamı.
Kitaplıklara çok fazla güvenmeyin
Apps Komut Dosyası kitaplıklarını kullanmak daha yavaş çalışacak bir eklenti tüm Apps Komut Dosyası kodunun tek bir komut dosyası projesinde bulunmasını sağlayabilirsiniz. Apps Komut Dosyası kitaplıkları eklentilerde çalışsa da performansla karşılaşabilirsiniz. azaltmanıza yardımcı olur. Dosyalarınıza gereksiz kitaplıklar eklemekten ve eklentinizin bunlara olan bağımlılığını azaltmanın yollarını düşünün.
Yukarıda açıklanan gecikme yalnızca kullanılan Apps Komut Dosyası projeleri için geçerlidir kitaplığını oluşturur. Aşağıdaki gibi istemci taraflı JavaScript kitaplıklarını kullanabilirsiniz: jQuery'yi kullanabilirsiniz.
Google Workspace eklentisi ile ilgili en iyi uygulamalar
Aşağıdaki en iyi uygulamalar yalnızca Google Workspace Eklentileri ve bunların kullanımı Kart hizmetinden yararlanın.
Yalnızca birkaç kart kullanma
Eklenti çok fazla kart kullanıyorsa gezinme yapılandırması yönetilmesi zor ve karmaşık hale gelir.
Gerektiğinden fazla kart oluşturma dürtüsünden kaçının.
Widget oluşturma işlevlerini kullanma
Card oluşturan kod yazarken
veya diğer karmaşık kullanıcı arayüzü nesnelerinde bu kodu kendi işlevine yerleştirmeyi düşünün.
Bu oluşturma işlevi, nesneyi derlemeli ve döndürmelidir. Bu şekilde
Kullanıcı arayüzünün yenilenmesi gerektiğinde
nesneyi hızlı bir şekilde yeniden üretiyorsunuz. Hatırlama
ve build() işlevini çağırın.
Kart hizmeti.
Kartları basit tutun
Bir kartta çok fazla widget varsa ekranın çok büyük bir kısmını kaplayabilir ve faydası azalır. Büyük kart bölümleri daraltılabilir kullanıcı arayüzü öğeleri olarak oluşturulurken bu, bilgiyi kullanıcıdan gizler. Eklentinizi basitleştirmeyi hedefleyin ve ihtiyacını ortadan kaldırıyor.
Hata kartlarını kullanma
Hata koşulları için kartlar oluşturun. Eklentiniz hata veriyorsa Hata bilgilerinin ve hatanın nasıl düzeltileceğine ilişkin talimatların bulunduğu bir kart görüntüle kullanmanızı öneririz. Örneğin, eklentiniz Google dışı bir hizmet sunduğunuzu gösteren bir e-posta alırsınız, bunu belirten bir kart görüntüleyin ve kullanıcının, kullanılan hesap bilgilerini doğrulaması gerekir.
Testler ve test mesajları yazma
Oluşturduğunuz tüm eklentileri kapsamlı bir şekilde test etmeniz gerekir. Şu özelliklere sahip test fonksiyonları oluşturun: test verilerini kullanarak kartlar ve widget'lar oluşturmalı ve ardından nesnelerin oluşturulmalıdır.
İşlem geri çağırma işlevlerini kullanırken genellikle bir yanıt nesnesi oluşturmanız gerekir. Örneğin, aşağıdaki adımları uygulayın:
Logger.log(response.printJson());
Doğrudan Apps Komut Dosyası'ndan oluşturduğunuz test işlevlerini çalıştırma düzenleyicisini Çalıştır menüsünü kullanarak düzenleyebilirsiniz. Uygun bir eklentiniz olduğunda yayınlanmamış sürümü yüklediğinizden emin olun Siz de test edebilirsiniz.
Eklentinin genişlettiği her ana makine uygulaması için uygun test verilerini kullanın. Örneğin, örneğin, eklenti Gmail'in kapsamını genişletiyorsa birkaç test e-postasına ihtiyacınız Böylece, eklentinin gerektiği gibi çalıştığından emin olmak için beklenen sonucu verir. Bir kullanarak mesajları listeleyerek Gmail API Users.messages.list yöntemini kullanarak veya Apps Komut Dosyası'nın Gmail hizmeti.
Takvim konferansı ile ilgili en iyi uygulamalar
Eklentiniz, üçüncü taraf uygulamalarını entegre ediyorsa takvim konferans görüşmesi diğer en iyi uygulamaları takip edin:
onCreateFunction ışığınızı koruyun
Her bir onCreateFunction
manifest dosyanızda tanımladığınız her şey eşzamanlı olarak çağrılır. Bir kullanıcı
konferans çözümü de oluşturabilirsiniz. Bu işlevlerin yalnızca
ve konferansı oluşturmak için gereken minimum çabayı ifade eder. Bu tür etkinliklerde
çok fazla şey yapmak,
işlevleri, eklentiniz için yavaş bir kullanıcı deneyimine neden olabilir.
Konferans verileri için uygun ConferenceData alanlarını kullanın
Bir e-posta,
ConferenceData
konferansla ilgili ayrıntılarla doldurabilirsiniz (erişim
kodlar, telefon numaraları, pin'ler, URI'ler vb.) bakın. İlgili alan adının
EntryPoint alanı
inceleyebilirsiniz. Bu ayrıntıları ConferenceData uygulamasına yerleştirmeyin
notlar alanına göz atın.
Google Takvim etkinliğine konferans ayrıntıları eklenmesin
Eklentinizin, oluşturulan üçüncü taraf hakkında bilgi eklemesi gerekmez. Google Takvim etkinlik açıklamasına ekleyin. Google Takvim bu işlemi otomatik olarak yapabilirsiniz.