Google Meet eklentisi tasarımıyla ilgili bu kılavuzları uygulayarak kullanıcılarınızın genel deneyimini iyileştirin.
Yetkilendirmeyle ilgili en iyi uygulamalar
Kimlik doğrulama veya yetkilendirme gerektiren tüm Google Meet eklentileri için aşağıdaki en iyi uygulamaları kullanmanızı öneririz.
Google ile oturum açma özelliğini kullanma
Google Workspace eklentilerinin çoğu kullanıcısı, toplantıya katılmadan önce Google'da oturum açmış olur. Bu nedenle, Google One Tap'in bir seçenek olarak sunulması, kullanıcılarınızın oturum açma akışında birkaç tıklama yapmasına engel olabilir. Daha fazla bilgi için Eklentinizin oturum açma yöntemlerini yönetme başlıklı makaleyi inceleyin.
Üçüncü taraf oturum açma sayfasını yeni bir pencerede açma
Uygulamanız, Google ile oturum açma özelliğine ek olarak başka oturum açma mekanizmaları da sunabilir. Bu durumda, oturum açma sayfasını yeni bir sekmede açmak yerine bir iletişim kutusu kullanın. Bu sayede kullanıcı, Meet görüşmesini görmeye ve görüşmeye geri dönmeye devam edebilir. Ayrıca, daha az tıklama yapması gerekir.
Google API'leri için kapsamları doğru şekilde isteme
Meet eklentiniz Google API'lerini çağırıyorsa eklentinizin gerektirdiği OAuth kapsamlarının tam listesini sağlamanız gerekir. Bu işlem, Google Workspace Marketplace Uygulama Yapılandırması sayfasında yapılır. Bu kapsamları ekledikten sonra kullanıcılarınız Meet eklentinizi yüklerken uygulamanızın erişmesine izin verdikleri veri türlerini belirten bir istem görür.
Eklentinizi yayınlamadan önce OAuth izin ekranını da ayarlamanız gerekir. Bunun için Google Workspace Marketplace uygulama yapılandırmanızdaki tam olarak aynı yetkilendirme kapsamlarını eklemeniz gerekir. OAuth izin ekranını yapılandırırken, kapsamlar istendiğinde gösterilen marka bilgilerini, gizlilik politikasını ve hizmet şartlarını da ayarlamanız gerekir. Herkese açık olarak yayınlanmak için bu bilgilerin tümü doğrulama için gönderilmelidir.
Google Workspace API'lerini çağıracak kod yazarken JavaScript Hızlı Başlangıç kılavuzunu takip etmek, başlamanın en kolay yoludur. Bu yaklaşım, Google ile oturum açma ve iletişim kutularını kullanmayla ilgili en iyi uygulamalara uygundur. JavaScript'te jeton istemcisini başlatmanın, uygulamanın çalışma zamanında gerçekten kullandığı kapsamları ayrı olarak istemeyi gerektirdiğini unutmayın. En iyi kullanıcı deneyimi için istenen kapsamlar, Google Workspace Marketplace Uygulama Yapılandırması sayfasındakilerle eşleşmelidir. Bu yedeklilik, kullanıcı kapsamları iptal ettiğinde kullanılacak yedek bir yöntem sağlar.
Bakımla ilgili en iyi uygulamalar
Aşağıdaki en iyi uygulamalar, sürdürülebilir web uygulamaları yazmak içindir ancak özellikle Meet eklentileri yazarken önemlidir.
Google Meet eklentileri SDK'sının en son sürümünü kullanın
Meet eklentileri SDK'sı düzenli olarak güncellenir. SDK, anlamsal sürümlemeye uyar. En son sürümü bulmak için:
- gstatic kullanılırken: En son SDK sürümü, SDK'yı kullanma talimatlarında bulunan gstatic URL'sinde yer alır.
- npm kullanılırken: Meet eklentinizi barındıran web sitesi için
package.jsondosyasını içeren dizindennpm update @googleworkspace/meet-add-onsdosyasını çalıştırın.
Bir hazırlık Google Cloud projesi oluşturun
Google Meet eklentiniz Google Workspace Marketplace'te yayınlandıktan sonra, Google Meet eklentinizin yeni dağıtımları Meet kullanıcıları tarafından anında kullanılabilir. Kullanıcılar, önbellekleri boşaltıldıktan veya önbelleğin süresi dolduktan sonra bu güncellemeleri görür. Bu nedenle, değişiklikler iyice test edilene kadar üretim sitenize aktarmamanız önerilir.
Doğrudan üretime dağıtımı önlemek için kuruluşunuza özel olarak yayınlanan ayrı bir Google Cloud projesi oluşturmanızı öneririz. Bu Cloud projesi, Meet eklentinizin hem hazırlık hem de geliştirme ortamlarını barındırır. Bu Cloud projesine erişim, doğrudan eklentinizin geliştirilmesi üzerinde çalışan daha küçük bir ekiple sınırlı olmalıdır.
Eklentiniz için bu alternatif ortamları oluşturmak üzere öncelikle, eklentinizi içeren web uygulamanızın alternatif ortamlarını sahip olduğunuz bir alanda barındırmanız gerekir. Ardından, Meet eklentiniz için alternatif ortamlar oluşturmak üzere hazırlık aşamasındaki Google Cloud projenize ek dağıtımlar ekleyebilirsiniz. Bu yeni dağıtımlarda, web uygulamanızın alternatif ortamlarını işaret eden manifest'ler olmalıdır. Ardından, her eklenti ortamını aşağıdaki şekilde yüklemenizi öneririz:
- Hazırlama: Kuruluşunuzdaki herkesin teste yardımcı olabilmesi için hazırlama sürümünü gizli olarak yayınlayın.
- Geliştirme: Meet eklentisinin geliştirme sürümünü yalnızca hesabınıza yüklemek için İşlemler sütununun altındaki Yükle'yi tıklayın.
Test yazma
Meet eklentinizi bir geliştirme ortamına dağıtmadan önce birim testleri yazmanızı öneririz. Birim testleriniz şunları içermelidir:
- Meet eklentileri SDK'sını taklit edin ve ardından Meet eklentisinin SDK işlevlerini beklendiği gibi çağırdığını doğrulayın.
- Eklentinizin SDK ile ilgili olmayan tüm işlevlerini tercih ettiğiniz web testi çerçevesiyle birim testi yapın.
Kullanıcı deneyimi ile ilgili en iyi uygulamalar
Aşağıdaki en iyi uygulamalar, Meet eklentilerinin daha sezgisel ve zarif olmasını sağlar.
Yan panelde tüm başlangıç durumlarını yönetme
Eklentinizi yan panelde yapılan kullanıcı işlemlerine göre ayarlamanız önemle tavsiye edilir.
Bu işlem, JavaScript'te etkinliğin başlangıç durumunu ayarlayarak yapılır. ActivityStartingState alanına eklenen tüm veriler, eklentiyi başlatan kullanıcı (genellikle toplantıyı düzenleyen) tarafından yan panelde ayarlanmalıdır. Yan panelin ilk görünümünü, eklentinizin kurulumunu kontrol eden bir form olarak düşünebilirsiniz.
Kullanmadığınız zamanlarda yan paneli kapatma
startActivity() yöntemini çağırarak etkinliği başlattıktan sonra, yan paneli yalnızca Google Meet eklentinizin kullanıcı deneyiminin önemli bir parçasıysa açık tutmanız gerekir. Ana aşama açıldığında unloadSidePanel() yöntemini çağırarak yan paneli kapatabilirsiniz.
Meet eklentinizi ekran paylaşımı üzerinden tanıtma
Meet eklentileri, ekran paylaşımından daha zengin bir deneyim sunar. Ancak birçok kullanıcı Meet'in ekran paylaşımı özelliğini kullanmaya alışmıştır. Bir kullanıcı, Meet eklentinizi barındıran web sitesini gösteren bir sekme paylaşırsa Meet, tüm görüşme katılımcılarına ilgili Meet eklentisini yüklemelerini veya kullanmalarını isteyen bir banner göstermek üzere yapılandırılabilir. Daha fazla bilgi için eklentinizi ekran paylaşımı aracılığıyla tanıtma başlıklı makaleyi inceleyin.
Logo tasarımı yönergeleri
Meet'e özel logonuzu tasarlarken hem şimdi hem de gelecekte en iyi şekilde görünmesi için aşağıdaki yönergelere uyun:
256 piksel x 256 piksel boyutunda PNG dosya biçimini kullanın.
Şeffaflık kullanın.
Meet eklentileri için geliştirici araçlarını kullanarak koyu moddaki logonuzun koyu modda iyi göründüğünü doğrulayın.
Belirli uygulama entegrasyonlarıyla ilgili grafik gereksinimlerine uyun.
Resminize dolgu eklemeyin. Bunun yerine resmi, dosyanızın sınırlarına kadar genişletin.