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 edinmek için Eklentiniz için oturum açma yöntemlerini yönetme başlıklı makaleye bakın.
Üçü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 Meet Eklentinizi yüklediklerinde, kullanıcılara uygulamanızın ne tür verilere erişmesine izin verdiklerini bildiren bir istem gösterilir.
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ın yapılandırılması için kapsamlar istendiğinde gösterilen marka bilgilerinin, gizlilik politikasının ve hizmet şartlarının da ayarlanması 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 en kolay yöntemdir. Bu yaklaşım, Google ile Oturum Açma ve iletişim pencerelerini kullanmaya yönelik en iyi uygulamalara uygundur. JavaScript'te jeton istemcisini başlatmak için uygulamanın çalışma zamanında aslında kullandığı kapsamların ayrı ayrı istenmesi gerektiğ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, bakımı yapılabilir 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üm oluşturmaya bağlıdır. En son sürümü bulmak için:
- gstatic kullanılırken: En son SDK sürümü, SDK'yı kullanma talimatlarındaki gstatic URL'de bulunur.
- npm kullanı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ı size ait 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ımların, web uygulamanızın alternatif ortamlarına işaret eden manifestleri olmalıdır. Ardından, her eklenti ortamını aşağıdaki şekilde yüklemenizi öneririz:
- Hazırlık: Kuruluşunuzdaki herkesin teste yardımcı olabilmesi için hazırlık sürümünü özel 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, JavaScript'te etkinlik başlangıç durumunun ayarlanmasıyla yapılır. ActivityStartingState'e giden tüm veriler, eklentiyi başlatan (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.
Kullanılmadığında yan paneli kapatın
Etkinliği startActivity() yöntemini çağırarak başlattıktan sonra, yan paneli yalnızca Google Meet Eklentiniz için kullanıcı deneyiminin
önemli bir parçasıysa açık tutmalısınız. 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, görüşmedeki tüm katılımcılara karşılık gelen Meet eklentisini yüklemelerini veya kullanmalarını isteyen bir banner gösterecek şekilde yapılandırılabilir. Daha fazla bilgi için ekran paylaşımı aracılığıyla eklentinizi tanıtma bölümüne bakın.
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 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üğünden emin olun.
Belirli uygulama entegrasyonlarıyla ilgili grafik gereksinimlerine uyun.
Resminize dolgu eklemeyin. Bunun yerine resmi, dosyanızın sınırlarına kadar genişletin.