En iyi uygulamalar

Kullanıcılarınızın genel deneyiminiz için Google Meet eklentisi tasarımı.

Yetkilendirmeyle ilgili en iyi uygulamalar

Aşağıdaki en iyi uygulamaları kullanmanızı öneririz: Kimlik doğrulama veya yetkilendirme gerektiren Google Meet eklentileri.

Google ile Oturum Açma'yı kullanma

Birçok Google Workspace eklentisi kullanıcısı daha önce Google'da oturum açmış olacaktır toplantıya katılıyor. Dolayısıyla, Google ile Oturum Açma'nın seçeneği olarak sunulur. Bu seçenek, kullanıcılarınızın dönüşüm gerçekleştirmeden önce hoş geldiniz.

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

Uygulamanız, Google ile oturum açma özelliğine ek olarak ek oturum açma seçenekleri de sunabilir mekanizmalar. Böyle bir durumda oturum açma sayfasını açmak yerine bir iletişim penceresi kullanın: yeni sekme açılır. Bu şekilde, kullanıcı sayfayı görmeye devam edebilir ve daha az tıklama alır.

Google API'leri için kapsamları doğru şekilde isteme

Meet Eklentiniz Google API'lerini çağırıyorsa OAuth'un tam listesini sağlamalısınız. kapsamlar gerekir. Bu işlem Google Workspace Marketplace Uygulama Yapılandırması sayfası. Bunları ekledikten sonra kapsamlarınızı yüklediklerinde, kullanıcılarınıza Kullanıcılara ne tür veriler kullandıklarını gösteren Meet eklentisi ve uygulamanızın erişmesine izin verin.

Eklentinizi yayınlamadan önce OAuth izin ayarlarını da tıklayın. Bu, uygulamanızdan tam olarak aynı yetkilendirme kapsamlarının eklenmesini gerektirir Google Workspace Marketplace Uygulama Yapılandırması. OAuth'u yapılandırma izin ekranında marka bilgilerinin, gizlilik politikasının, ve kapsamlar istendiğinde görüntülenen hizmet şartlarıdır. Yayınlamak için herkese açık bir şekilde, tüm bu bilgilerin doğrulama başlıklı makaleyi inceleyin.

Google Workspace API'lerini çağırmak için kod yazarken JavaScript Hızlı başlangıç kılavuzu işe başlamanın en kolay yoludur. Bu yaklaşım, benimsenmesini sağlayan Google ile Oturum Açma ve iletişim pencerelerini kullanabilirsiniz. Jetonu başlatmanın müşteri uygulamanın kullanma konusunda yardımcı olabilir. En iyi kullanıcı deneyimi için istenen bu kapsamlar Google Workspace Marketplace Uygulama Yapılandırması'ndakilerle eşleşmelidir sayfasını ziyaret edin. Bu yedeklilik, başka bir e-postada herhangi bir sorun bir kullanıcı iptal etti kapsamlarını inceleyin.

Bakımla ilgili en iyi uygulamalar

Aşağıdaki en iyi uygulamalar, sürdürülebilirlik açısından ancak bu dosyalar özellikle de Meet eklentileri.

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. En son sürümü bulmak için:

  • gstatic kullanılırken: En son SDK sürümü, gstatic URL, SDK'yı kullanma talimatlarında bulunur.
  • npm kullanırken: npm update @googleworkspace/meet-add-ons öğesini içinden çalıştırın package.json içeren dizin web sitesine gidin.

Hazırlık Google Cloud projesi oluşturma

Google Meet Eklentiniz Google Workspace Marketplace Google Meet Eklentinizin yeni dağıtımları anında Meet kullanıcılarının erişimine açık. Kullanıcılar bu güncellemeleri kullanıcılar önbelleklerini boşaltır, yoksa önbelleğin süresi dolar. Dolayısıyla, ve değişiklikler tam olarak test edilene kadar üretim sitenizde değişiklik yapma.

Doğrudan üretime dağıtmayı önlemek için ayrı bir Google Cloud projesi . Bu Cloud projesi hem hazırlık hem de geliştirme ortamları için geçerlidir. Erişme bu Cloud projesinde çalışan küçük bir ekiple sınırlı olmalıdır. geliştirme üzerinde doğrudan çalışmalıdır.

Eklentiniz için bu alternatif ortamlar oluşturmak üzere önce web uygulamanızın farklı ortamları için barındırması sahip olduğunuz bir alanda eklentinizi içeriyorsa. Ardından, işletmeniz ve kullanıcılarınız için alternatif ortamlar Meet eklentisine dağıtımlar Google Cloud projenize ekleyin. Bu yeni dağıtımlarda web uygulamanızın alternatif ortamlarına işaret eden manifest'ler dosyası oluşturur. Daha sonra tüm eklentilerinizi tek tek yüklemenizi şu şekilde kullanabilirsiniz:

  • Hazırlık: Hazırlık sürümünü özel olarak yayınlama Böylece kuruluşunuzdaki herkes teste yardımcı olabilir.
  • Geliştirme: Uygulamanızı yüklemek için İşlemler sütununun altında Yükle'yi tıklayın Yalnızca sizin hesabınız için eklenti geliştirme sürümüyle tanışın.

Testleri yazma

Meet Eklentinizi bir geliştirmeye dağıtmadan önce birim testleri yazmanızı öneririz. Birim testleriniz şunları içermelidir:

  • Meet Eklentileri SDK'sı örneği oluşturma ve ardından Meet eklentisi, SDK işlevlerini beklendiği gibi çağırır.
  • Uygulamanızın SDK ile ilgili olmayan tüm işlevlerini tercih ettiğiniz web testi çerçevesini ekleyin.

Kullanıcı deneyimi ile ilgili en iyi uygulamalar

Aşağıdaki en iyi uygulamalar, Meet eklentisi oluşturmanıza yardımcı olur ve rafine edilmiş olabilir.

Tüm başlangıç durumlarını yan panelde yönetme

Eklentinizi Yan panelde gerçekleştirilen kullanıcı işlemleri. Bu, ortak çalışma başlangıcının durumu: JavaScript'e dokunun. Kampanyaya dahil edilen tüm veriler CollaborationStartingState başlatan kişi tarafından ayarlanmalıdır (genellikle Toplantıyı düzenleyen kullanıcı) yan panelde görebilirsiniz. İlk görünümü ilk olarak yan panelden e-posta adresinize ekleyebilirsiniz.

Kullanılmadığında yan paneli kapatın

Şu numarayı arayarak etkinliği başlattıktan sonra: startCollaboration, yalnızca yan paneli saklamalısınız ve web sitenizin kullanıcı deneyiminin önemli bir parçasıysa, Google Meet eklentisi Yan paneli kapatabilirsiniz. Ana panel aşama şöyle görünür: unloadSidePanel.

Ekran paylaşımı aracılığıyla Meet Eklentinizi 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ışkın. özelliğini kullanabilirsiniz. Bir kullanıcı, sayfanızı barındıran web sitesini görüntüleyen bir sekme paylaşırsa Meet eklentisinde, Meet tüm görüşme katılımcılarına, kendilerinden Meet Eklentisi'ni tıklayın. Daha fazla bilgi için bkz. eklentinizi ekranda göstermek paylaşım.