Google Workspace Marketplace ile ilgili uygulama inceleme süreci ve gereksinimleri

• Uygulamayla iletişim kurmak için düğmelere açıklamadan erişebilirsiniz.
• Uygulama adı A-Z (büyük harf) veya 0-9 ile başlar. Simgeyle başlayamaz.

• Uygulama, bir kullanıcı doğrudan mesaj başlattığında veya uygulama bir alana eklendiğinde istemsiz bir karşılama mesajı gönderir. Karşılama mesajı, "Yardım" komutundan farklıdır. Daha fazla bilgi için Google Chat uygulaması için ana sayfa oluşturma bölümüne bakın.
• Uygulama, "Yardım" komutunu destekler ve kullanıcıların uygulamayı kullanmaya başlamasına yardımcı olur. Daha fazla bilgi için Eğik çizgi komutlarına yanıt verme bölümüne bakın.
• Uygulama, alanda veya doğrudan Chat'te kendisine seslenildiğinde her zaman yanıt verir.
• Mesajlar'da yazım, büyük harf kullanımı, noktalama ve dil bilgisi kuralları doğrudur. Mesajlar kötü amaçlı, rahatsız edici veya kötüye kullanım amaçlı materyaller içermez.
• Mesajlar, Google şartlarına uygun olarak metin veya kartlar için net, kısa ve tutarlı bir biçimlendirme kullanır.
• Yanıt 2 saniyeden uzun sürerse uygulama, gecikmeyi açıklayan bir mesaj gönderir.
• Bildirim gönderen uygulamalar, kullanıcıların bildirimleri kapatmasına izin verir.
• Kullanıcılar @bahis özelliğini kullanarak uygulamayı bir alana ekleyebilir.
• Kullanıcılar, Üyeleri görüntüle menüsünü kullanarak uygulamayı alandan kaldırabilir.
• Uygulama, kullanıcıya uygulamayla etkileşime geçmek için gereken her şeyi gösterir.
• Uygulamanın kullandığı kart biçimi Google şartlarını karşılamalıdır. Etkileşimli kartlar oluşturma başlıklı makaleyi inceleyin.
• Uygulamayı Chat menüsündeki Uygulama bul seçeneğinden bulabilirsiniz.
• Uygulamanın etkileşimde bulunduğu harici URL'ler bir hazırlık veya geliştirme ortamına ait olmamalıdır.
• Alanlardaki uygulamaya gönderilen her mesajda @bahset özelliğinin kullanılması zorunludur. Uygulamanın yanıt vermesi gereken tek yol budur.
• Chat uygulaması, üçüncü taraf alan adlarından gelen bağlantıları önizliyorsa:
  • Bağlantı önizlemeleri, kullanıcının mesajıyla alakalı ve ek bilgiler sunar. Örneğin, bir satış anlaşmasının bağlantısını önizlediğinizde hesap, tutar ve aşama gibi bilgiler eklenir.
  • Geliştirici, önizlenen alanla ilişkilidir.

  Daha fazla bilgi için Bağlantıları önizleme başlıklı makaleyi inceleyin.

• (Önerilir) Workspace yöneticilerinin, uygulamanızı kuruluşlarındaki kullanıcılar adına yüklemesine izin vermek için uygulamanızın doğrudan mesaj alıp gönderebilmesi gerekir.

• Uygulamanın tanınabilir ve net bir avatarı olmalıdır.

• Uygulama, Drive HTML'sini doğrudan değiştirerek işlev sağlamak için Chrome tarayıcı uzantılarını kullanmaz.
• Uygulamanız hassas veya kısıtlı kapsamlar kullanıyorsa OAuth doğrulamasından geçirilmelidir. Doğrulama için nasıl gönderim yapabilirim? başlıklı makaleyi inceleyin.
• Uygulamanız kısıtlanmış kapsamlar kullanıyorsa güvenlik değerlendirmesinden de Güvenlik değerlendirmesi neden gereklidir? başlıklı makaleyi inceleyin.

• Uygulama, dosyaları Drive'da depoluyorsa kullanıcıların bir klasör seçmesine izin verir veya uygulamaya özel bir klasör oluşturup yeniden kullanır. Yapılandırma verileri, bir Uygulama Verileri klasöründe depolanabilir. Uygulama, dosyaları kullanıcının Drive'ım klasörüne aktarmaz.
• Uygulama, yalnızca uygulamanın belgelenmiş işlevine bağlı olarak Drive'da dosya depolar.

• Beklenen ve gerekli işlemler eklentiye dahildir ve iş akışını tamamlamak için gereken tüm araçları sağlar. Örneğin:
  • Eklenti, stili belgenin tamamına uyguluyorsa stili yalnızca seçili metne uygulama seçeneği sunulur.
  • Eklenti, e-tablo verilerini bir web hizmeti feed'ine yüklüyorsa kolay gezinme için bu feed'e bağlantı içerir.
  • Eklenti, kullanıcının hesap sahibi olmasını gerektiriyorsa kullanıcının henüz hesabı yoksa kolayca hesap oluşturabileceği bağlantılar veya bilgiler sağlar.
• Eklentinin eklentiler sekmesinde menü öğeleri bulunur.
• Eklenti yalnızca özel işlevlerden oluşsa bile uygun dokümanları içermelidir.
• Eklenti, menüsünü doldurmak için onInstall() ve onOpen() uygulamalarını doğru şekilde kullanıyor. Menü öğeleri, eklenti ilk yüklendiğinde ve farklı bir dosya açıldığında doldurulur. Düzenleyici eklentisi yetkilendirme başlıklı makaleyi inceleyin.
• Yetkilendirme modları doğru şekilde ayarlanmalıdır. Yetkilendirme modları başlıklı makaleyi inceleyin.
• Eklenti, Apps Komut Dosyası'nın V8 çalışma zamanına uygulanmış olmalıdır. Daha fazla bilgi için V8 çalışma zamanına genel bakış başlıklı makaleyi inceleyin.

• Eklentiyi kullanarak ürün hakkında temel bilgiler edinebilir ve ürünü nasıl kullanacağınızı öğrenebilirsiniz.
• Kitaplıklar, eklentinin performansını kaybetmesine neden olabileceğinden eklenti kodu, kitaplıkları çok fazla kullanmaz.
• Mümkünse hatalar önlenir ve düzgün şekilde yönetilir. Aksi takdirde:
  • Hata mesajları, JavaScript uyarısında veya varsayılan kırmızı çubukta değil, bir iletişim penceresinde gösterilir. Sorunu bildirmeli ve kullanıcının sorunu düzeltmek için yapması gerekenleri basit bir dille açıklamalıdır.
  • Mümkün olduğunda, kullanıcı yanlış bir şey yapıyorsa sorunu çözen bir düğme gösterilir.
  • Daha fazla bilgi için eklenti stil kılavuzuna bakın.
• Harici sayfalara ait bağlantılar yeni pencerelerde açılır ve doğrudur.
• Eklenti sezgisel ve iyi tasarlanmış. Bu ne anlama geliyor?
  • Ne yapılması gerektiği ve nasıl yapılacağı her zaman nettir.
  • Eklenti, erişilebilir ve anlaşılması kolay bir eklentidir. Teknik terimler ve jargondan kaçınılır.
  • İş akışları mümkün olduğunca net ve kolay olmalıdır.
  • Kullanıcı ve içerikleri mümkün olduğunca güvendedir.
• Eklentiler, düzenleyici eklentileri için kullanıcı arayüzü stil kılavuzundaki yönergelere uyar ve düzenleyici eklentileri için CSS paketini kullanır.
• Eklentide ekran başına yalnızca bir mavi birincil işlem kullanılır.
• Eklenti, aynı anda bir iletişim kutusu gösterir. Aynı anda birden fazla iletişim kutusu açık olmamalıdır.
• Eklentinin kullanıcı arayüzü, ayrılan alanlara düzgün şekilde sığar:
  • Metin ve etiketler "..." ile kesilmiyor
  • Kullanıcının çok fazla dikey kaydırma yapması gerekmez.
  • İçerik genişliği 300 p'den fazla olmadığından yatay kaydırma çubuğu yoktur.
• Eklentinin onay gerektirmesi veya tüm hassas işlemler için uyarı göstermesi. Örneğin, eklenti bir e-tablodaki tüm içeriğin üzerine yazmak üzereyse kullanıcı uyarılır ve işlem gerçekleşmeden önce işlemi onaylar.

  Tasarım değişiklikleri yaparak bu şarttan kaçınabilirsiniz. Örneğin, verileri içe aktaran bir Google E-Tablolar eklentisi, mevcut içeriğin üzerine yazma riski oluşturur. Varsayılan işlem olarak veriler için bir sayfa oluşturarak riski kaldırabilirsiniz.

• Kullanıcılar, bir işlem yüklenirken işlemleri birden çok kez tetikleyemez. Örneğin, bir işlem yüklenirken düğmeler devre dışı bırakılır veya gizlenir.

Takvim eklentileri

• Eklenti calendar.name veya common.name kullanıyorsa manifestteki ad, uygulama girişinde belirtilen adla aynı olur.
• Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümünün adında "Google Takvim" bulunmaz.
• (Önerilen) Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümü adı 30 karakteri aşmamalıdır.

• Eklentinin, istenen işlev için doğru widget'ları (veya Meet eklentilerindeki iframe'li kullanıcı arayüzünü) kullanması gerekir. Örneğin, bir boole değerini seçmek için anahtar kullanabilirsiniz.

Takvim eklentileri

• İkincil takvimler ve yetkilendirme desteklenir veya desteklenmiyorsa sorunsuz bir şekilde yönetilir. Örneğin, kullanıcı etkinlik oluştururken düzenleme erişimi olan farklı bir takvim seçerse konferans oluşturma işlemi başarısız olmaz.
• Yinelenen etkinlikler düzgün şekilde çalışır.
• Eklentide calendar.conferenceSolution kullanılıyorsa en az bir konferans çözümü sağlanır.
• Eklenti konferans çözümleri sağlıyorsa uygun konferans veri alanları kullanılır. Örneğin, video konferans bağlantıları, telefon numaraları, SIP bağlantıları, erişim kodları ve desteklenen diğer özellikler yapılandırılmış veri alanlarını kullanır ve notlar alanında sağlanmaz.
• Eklenti konferans çözümleri sağlıyorsa yalnızca konferans ayrıntılarını düzenler ve başka etkinlik alanlarını düzenlemez.
• Eklentinin sunduğu konferans çözümleri varsa konferans oluşturma işlemi 5 saniyeden kısa sürer.

Gmail eklentileri

Eklenti UrlFetchApp veya OpenLinkUrl kullanıyorsa:

• URL geçerli.
• URL, HTTP değil HTTPS kullanıyor.
• Tam alan belirtilmişse.
• Yol boş değildir. Örneğin, https://altostrat/ kabul edilir ancak https://altostrat kabul edilmez.
• UrlFetchApp dilinde joker karakterler kullanılamaz.

Meet Eklentileri

• Üçüncü taraf çerezleri devre dışı bırakılmış olsa bile eklenti girişi ve kullanıcı yolculukları çalışır durumda olmalıdır.
• Eklentinin, toplantının işleyişiyle veya toplantıya katılımla ilgili işlevler sağlaması gerekir.
• Eklenti, kullanıcıların toplantıdan çıkmasını sağlayacak işlemler (ör. tarayıcıyı yenileme) yapmamalıdır.
• Çok oyunculu deneyim kullanılıyorsa eklenti, izinler önceden ayarlanmasa bile tüm katılımcıların içerik üzerinde ortak çalışmasına izin vermelidir. İzin düzenlemesi, ortak çalışmaya dayalı eklenti oturumu sırasında kullanılabilir olmalıdır.
• Eklenti, etkinlik başlatma akışının iptal edilmesini yönetmeli ve kullanıcının uygulamadan etkinliğin başlatılmasını yeniden başlatmasına izin vermelidir.
• Eklentinin, etkinlik deneyiminin oturum açılması ve ayarlanması için bir yan panel sağlaması gerekir.
• Eklentinin, bot davet etme işlevi sunmaması veya toplantıda bot varlığına dayalı olmaması gerekir.

• Eklentinin ana sayfası olmalıdır. Google Workspace eklentiniz dönüştürülmüş bir Gmail eklentisi ise varsayılan bir ana sayfa uygulanır.
• Eklenti kartı (veya Meet Eklentilerinde iFrame uygulanmış kullanıcı arayüzü) düzgün şekilde çalışıyor. Örneğin, kopya öğe yoktur; geri, yenile ve güncelle düğmeleri buna göre çalışır.
• Kullanıcı eklentiyi yetkilendirdikten sonra, kullanıcıyı karşılamak için özelleştirilmiş bir ana sayfa kartı (Meet eklentilerindeki web sayfası) görüntülenir. Bu kartta oturum açma düğmesi (gerekirse), eklentinin logosu ve kısa açıklaması yer alır.
  • Oturum açma düğmesi tetiklenirse üçüncü taraf tedarikçiden özelleştirilmiş bir oturum açma sayfası gösterilir. Bu sayfa, Google Workspace dışında çalışan bir üçüncü taraf hizmeti olduğunu açıkça belirtir.
• Eklentinin kullanıcı arayüzü, ayrılan alanlara düzgün bir şekilde sığar:
  • Metin ve etiketler "..." ile kesilmiyor.
  • Kullanıcının çok fazla dikey kaydırma yapması gerekmez.
  • İçerik genişliği 300 p'den fazla olmamalıdır. Aksi takdirde yatay kaydırma çubuğu eklenir.
• Kitaplıklar, eklentinin performansını düşürebileceğinden eklentinin kodunda kitaplıklar aşırı ölçüde kullanılmamalıdır.

Takvim eklentileri

• Eklentinin konferans çözümleri sağladığı durumlarda, oluşturulan konferanslar geçerlidir ve üçüncü taraf konferans web sitesinde düzgün şekilde gösterilir.

Dokümanlar eklentileri

Eklenti, üçüncü taraf alan adındaki bağlantıları (akıllı çipler) önizliyorsa:

• Bağlantı önizlemeleri, kullanıcıya alakalı ve tamamlayıcı bilgiler sunar. Örneğin, bir satış anlaşmasının bağlantısını önizlediğinizde hesap, tutar ve aşama gibi bilgiler eklenir.
• Geliştirici, önizlenen alanla ilişkilidir.

Daha fazla bilgi için Akıllı çiplerle bağlantıları önizleme bölümüne bakın.

Drive eklentileri

• Uygulama, Drive'da dosya depolıyorsa kullanıcıların klasör seçmesine izin veriyor veya uygulamaya özel bir klasör oluşturup yeniden kullanıyor. Yapılandırma verileri bir Uygulama Verileri klasöründe depolanabilir. Uygulama, kullanıcının Drive'ım klasörüne dosya aktarmaz.
• Eklentinin Drive'da sakladığı dosyalar yalnızca eklentinin belgelenmiş işleviyle bağlantılı olmalıdır.

Gmail eklentileri

• Eklentide, Chrome tarayıcı uzantılarından bahsedilmiyor veya bunlara gerekçesiz olarak bağlantı verilmiyor.
• Diğer işlemler menüsü more_vert düzgün çalışan evrensel işlemleri içerir. Örneğin, Çıkış yap, Hakkında, Destek vb.

Meet Eklentileri

• Eklentinin lisans veya abonelik gerektirmesi durumunda: Kullanıcının lisansı yoksa kullanıcıya kullanıcı dostu bir mesaj gösterilmelidir.
• Kullanıcı, lisanslama sorunu nedeniyle eklentiyi kullanamıyorsa hata mesajında, eklentinin kullanılamamasının nedeni açıkça belirtilmeli ve kullanıcının durumu düzeltmesi için bir işlem önerisi sunulmalıdır.
• Eklentinin Google Workspace Marketplace girişinde, eklentinin kullanılması için gerekli olabilecek lisans ve abonelik koşullarıyla ilgili ayrıntılar belirtilmelidir. Eklentinin ücretli bir katmanı varsa Pazar Yeri girişinde, fiyatlandırma veya satış temsilcisiyle nasıl iletişime geçileceği hakkında daha fazla bilgi sunan bir web sayfasının bağlantısı sağlanmalıdır.
• Kullanıcı oturum açmamışsa eklenti, Google One Tap'i Göster bölümündeki One Tap oturum açma istemini ve Kimlik Doğrulama bölümündeki "Google ile oturum aç" yedek seçeneğini göstermelidir. "Google ile oturum aç" mekanizmasına ek olarak başka giriş seçenekleri de sunulabilir.
• Eklentinin, içeriği farklı boyutlara uyarlayabilen duyarlı bir tasarımı olmalıdır.
• Üçüncü taraf çerezleri devre dışı bırakılsa bile eklenti kullanıcı yolculukları işlevsel olmalıdır.
• Eklentinin iFrame içinde yatay kaydırma özelliği olmamalıdır.
• Ana sahneyi kullanmak isteyen eklentiler, çok oyunculu deneyimler için tasarlanmış olmalı ve içeriğin aynı anda birden fazla katılımcı tarafından değiştirilmesine izin vermelidir. Tek oyunculu deneyimler için geliştiricinin yan paneli kullanması gerekir.
• (Önerilir) Eklenti, oturum açmış kullanıcının kim olduğunu göstermelidir.
• (Önerilir) Yerelleştirme seçimi: Dil, varsa tarayıcı tarafından ayarlanan yerel tercihe göre belirlenmelidir.
• (Önerilen) İçerik seçimi, en son erişilen içeriğin yer aldığı bir içerik tarama arayüzü üzerinden yapılmalıdır.
• (Önerilir) Yan panele artık ihtiyaç duyulmuyorsa eklenti, ana aşamada başlatıldıktan sonra yan paneli kapatmalıdır.

Takvim eklentileri

• Konferans çözümünün logosu herkese açık bir URL'dir. Konferans çözümü logolarını sağlama başlıklı makaleyi inceleyin.
• Eklentide calendar.conferenceSolution kullanılıyorsa konferans çözümünün logosu calendar.logoUrl koşullarına uygun olmalıdır. Takvim manifesti kaynağı başlıklı makaleyi inceleyin.
• Eklenti calendar.logoUrl veya common.logoUrl kullanıyorsa logo, uygulama girişinde belirtilen simgeyle aynı olur.
• Eklenti calendar.logoUrl veya common.logoUrl kullanıyorsa logonun URL'si şu şekilde başlar: https://lh3.googleusercontent.com/

Meet Eklentileri

• Eklentinin marka logosunun, Meet yan panelinden tanımlanabilir bir boyut ve stilde olması gerekir.
• Uygun koyu mod logo URL'leri eklenti manifest belirtilmelidir.

Drive eklentileri

• (Önerilir) Sınırlı meta veri almak istiyorsanız eklenti, drive.addons.metadata.readonly kapsamını içerir.

• Evrensel gezinme URL'si bir web uygulamasına yönlendirir. İşlev içermeyen basit bir web sayfası, web uygulaması olarak kabul edilmez.