En iyi uygulamalar

Google Meet eklenti tasarımına yönelik bu kılavuzları uygulayarak kullanıcılarınızın genel deneyimini iyileştirin.

Yetkilendirme ile 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 önerilir.

Google ile oturum açma özelliğini kullanma

Google Workspace eklentilerinin birçok kullanıcısı, toplantıya katılmadan önce Google'da oturum açmış olur. Bu nedenle, Google One Tap'in seçenek olarak sunulması, kullanıcılarınızın oturum açma akışında birkaç tıklama yapmasını önleyebilir. Daha fazla bilgi için Eklentiniz için oturum açma yöntemlerini yönetme başlıklı makaleyi inceleyin.

Üçüncü taraf oturum açma sayfasını yeni bir pencerede açın.

Uygulamanız, Google ile oturum açmaya ek olarak başka oturum açma mekanizmaları da sunabilir. Bu durumda, yeni sekmede oturum açma sayfası açmak yerine iletişim kutusu kullanın. Bu sayede kullanıcı, Meet görüşmesini görmeye ve görüşmeye geri dönmeye devam edebilir ve daha az tıklama yapar.

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üklediğinde uygulamanızın hangi tür verilere erişmesine izin verdiklerini belirten bir istem gösterilir.

Eklentinizi yayınlamadan önce OAuth izin ekranını da ayarlamanız gerekir. Bu işlem için Google Workspace Marketplace Uygulama Yapılandırmanızdan tam olarak aynı yetkilendirme kapsamlarının eklenmesi gerekir. OAuth onay ekranının yapılandırılması için kapsamlar istendiğinde gösterilen markalama bilgilerinin, gizlilik politikasının ve hizmet şartlarının da ayarlanması gerekir. Herkese açık olarak yayınlamak için tüm bu bilgilerin doğrulamaya gönderilmesi gerekir.

Google Workspace API'lerini çağırmak için kod yazarken JavaScript Hızlı Başlangıç Kılavuzu'nu izlemek, başlamanın en kolay yoludur. Bu yaklaşım, Google ile Giriş ve iletişim kutularını kullanmayla ilgili en iyi uygulamalara uygundur. JavaScript'te jeton istemcisinin başlatılması için uygulamanın çalışma zamanında kullandığı kapsamların ayrı olarak istenmesi gerektiğini unutmayın. En iyi kullanıcı deneyimi için, istenen bu kapsamlar Google Workspace Marketplace Uygulama Yapılandırması sayfasındaki kapsamlarla eşleşmelidir. Bu yedeklilik, kullanıcının kapsamları iptal ettiği durumlarda sorunu çözmek için bir geri dönüş seçeneği sunar.

Bakımla ilgili en iyi uygulamalar

Aşağıdaki en iyi uygulamalar, sürdürülebilir web uygulamaları yazmak için geçerlidir 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şturma standardına uygundur. 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ırken: Meet eklentinizi barındıran web sitesinin package.json dosyasını içeren dizinde npm update @googleworkspace/meet-add-ons komutunu ç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, önbelleklerini boşalttıkları veya önbelleğin süresi dolduğu anda bu güncellemeleri görür. Bu nedenle, değişiklikler kapsamlı bir şekilde test edilene kadar üretim sitenize aktarmamanızı öneririz.

Doğrudan üretime dağıtımı önlemek için kuruluşunuzda özel olarak yayınlanan ayrı bir Google Cloud projesi oluşturmanızı öneririz. Bu Cloud projesi, Meet eklentinizin hem hazırlama hem de geliştirme ortamlarını barındırır. Bu Cloud projesine erişim, eklentinizin geliştirilmesi üzerinde doğrudan çalışan daha küçük bir ekiple sınırlandırılmalıdır.

Eklentiniz için bu alternatif ortamları oluşturmak istiyorsanız öncelikle eklentinizi içeren web uygulamanızın alternatif ortamlarını, sahibi olduğunuz bir alanda barındırmanız gerekir. Ardından, hazırlama Google Cloud projenize ek dağıtımlar ekleyerek Meet eklentiniz için alternatif ortamlar oluşturabilirsiniz. Bu yeni dağıtımlarda, web uygulamanızın alternatif ortamlarına işaret eden manifestler olmalıdır. Ardından, her eklenti ortamını aşağıdaki gibi 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ütununda Yükle'yi tıklayın.

Test yazma

Meet eklentinizi geliştirme ortamına dağıtmadan önce birim testleri yazmanızı öneririz. Birim testleriniz şunları içermelidir:

  • Meet eklentileri SDK'sını taklit edip 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ı deneyimiyle ilgili en iyi uygulamalar

Aşağıdaki en iyi uygulamalar, Meet eklentilerinin daha sezgisel ve gelişmiş olmasına yardımcı olur.

Yan paneldeki tüm başlangıç durumunu yönetme

Eklentinizi, yan panelde gerçekleştirilen kullanıcı işlemlerine göre ayarlamanızı önemle tavsiye ederiz. Bu işlem, JavaScript'te etkinliğin başlangıç durumunu ayarlayarak yapılır. ActivityStartingState içine giren tüm veriler, eklentiyi başlatan kişi (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 kapatma

startActivity() yöntemini çağırarak etkinliği başlattıktan sonra, yan paneli yalnızca Google Meet eklentiniz için kullanıcı deneyiminin önemli bir parçasıysa açık tutmanız gerekir. Ana sahne açıldıktan sonra unloadSidePanel() yöntemini çağırarak yan paneli kapatabilirsiniz.

Ekran paylaşımıyla Meet eklentinizi tanıtma

Meet eklentileri, ekran paylaşımına kıyasla daha zengin bir deneyim sunar. Ancak birçok kullanıcı Meet'in ekran paylaşımı özelliğini kullanmaya alışkındır. Bir kullanıcı, Meet eklentinizi barındıran web sitesini gösteren bir sekmeyi paylaştığında Meet, tüm görüşme katılımcılarına ilgili Meet eklentisini yüklemelerini veya kullanmalarını isteyen bir banner gösterecek şekilde 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çimi kullanın.

Şeffaflık kullanın.

Meet eklentileri için geliştirici araçlarını kullanarak koyu mod logosunun koyu modda iyi göründüğünü doğrulayın.

Web Accessibility In Mind (WebAIM) tarafından sunulan Contrast Checker gibi bir kontrast kontrol aracı kullanarak logonuzun (ve diğer grafik öğelerinizin) yüksek kontrast modunda iyi göründüğünü doğrulayın.

Belirli uygulama entegrasyonlarıyla ilgili grafik şartlarına uyun.

Resminize dolgu eklemeyin. Bunun yerine, resmi dosyanızın sınırlarına kadar genişletin.