Google Workspace Marketplace için uygulama inceleme süreci ve gereksinimleri

Google, bir uygulamayı Google Workspace Marketplace'te herkese açık olarak yayınlamak için uygulamanızı ve girişinizi inceleyerek Google'ın tasarım, içerik ve stil yönergelerine uygun olup olmadığını kontrol eder.

Google, uygulamanızı inceledikten sonra, üzerinde daha fazla çalışılması gerekip gerekmediği veya onaylanıp onaylanmadığı hakkında bir e-posta alırsınız.

  • Uygulamanız ek çalışma gerektiriyorsa: İyileştirilmesi gereken noktalarla ilgili ayrıntılı bilgiler içeren bir inceleme belgesi alırsınız. Sorunları giderin ve uygulamanızı yeniden incelemeye gönderin.
  • İnceleme ekibi uygulamanızı onaylarsa: Uygulamanız otomatik olarak yayınlanır ve bir bildirim e-postası alırsınız.

Uygulamanızı incelemeye göndermeden önce, yayınlanmaya hazır olduğundan emin olun. Ayrıntılı bilgi için Yayınlama süreci için hazırlanma başlıklı makaleyi inceleyin.

İnceleme süresi

Uygulama inceleme işlemi genellikle birkaç gün sürer. Bu işlemin ne kadar süreceği aşağıdakilere bağlıdır:

  • Son zamanlarda gönderilen uygulamaların sayısı
  • Uygulamanız için ne kadar ek çalışma gerekiyor?

Bir uygulamanın incelemeyi geçememesinin yaygın nedenleri

OAuth doğrulaması:

  • OAuth izin ekranı yanlış ayarlanmış. Örneğin, kullanıcı türü Dahili veya yayınlama durumu Test olarak ayarlanmıştır.
  • Uygulama, OAuth doğrulamasını tamamlamamıştır.

Uygulama girişi sorunları:

  • Uygulama adında, logosunda veya uygulama açıklamalarında Google'a ait ticari markaların uygunsuz kullanımı. Rehberlik için Google Workspace Marketplace markalama kurallarına bakın.
  • Bağlantılar çalışmıyor veya yanlış bilgilere yönlendiriyor. Örneğin, bir gizlilik politikası bağlantısı, bir geliştirici destek sayfasına yönlendiriyor.
  • Ekran görüntüleri ve resimler düşük kaliteli veya uygulama işlevselliğini doğru temsil etmiyor.

Uygulama hazırlık durumu:

  • Uygulama hâlâ test aşamasında olup genel kullanıma açılmaya hazır değildir.
  • Uygulamada hatalar var veya tam olarak işlevsel değil.

Ölçütleri inceleyin

Uygulamanızı incelemeye göndermeden önce, uygulamanızın tüm gereksinimleri karşıladığından ve Google Workspace Marketplace program politikalarına uyduğundan emin olun.

Tüm uygulamalar için gereksinimler

Ön incelemenizi takip etmek için onay kutularını kullanabilirsiniz.

Kategori Ölçütler
Uygulama adı
  • Aynı ada sahip başka uygulama girişi yok.
  • Ad, sürüm numarası içermiyor.
  • Ad, OAuth izin ekranındaki adla eşleşmelidir.
  • Ad belirsiz veya genel değil.
  • Ad en fazla 50 karakterden oluşmalıdır.
  • (Önerilir) Adın ilk harfi büyük olur.
  • (Önerilir) Adda noktalama işareti, özellikle parantez işaretleri yoktur.
Geliştirici bilgileri
  • Geliştirici adı ve geliştirici web sitesi, geliştiriciyle ilgili bilgileri doğru şekilde temsil eder ve geliştiriciyle ilgili bilgilere yönlendirir.
  • Tüketiciyi koruma yasaları nedeniyle, Avrupa Ekonomik Alanı'ndaki (AEA) tüketiciler, Google Workspace Marketplace'teki satıcının tacir mi yoksa tacir olmayan mı olduğu konusunda bilgilendirilmelidir:
    • Tüccar - Tüccar bir ticaret, işletme, zanaat veya meslekle ilgili amaçlar için ya da tacir adına veya tacir adına hareket eden kişidir.
    • Tüccar olmayan - Tüccar olmayan (tüketici), profesyonel olmayan amaçlarla hareket eden bir kişidir.

    Belirtilmemişse uygulamanızın mağaza girişi sayfasında "Tüccar durumu belirtilmedi" ifadesi görünür.

Uygulama açıklaması
  • Sağlanan tüm bağlantılar çalışıyor ve doğru bilgileri gösteriyor. Örneğin, bir gizlilik politikası bağlantısı, gizlilik politikasını açıklayan bir sayfaya yönlendirir.
  • Uygulama bir üçüncü taraf hizmetiyle etkileşim kuruyorsa açıklamada üçüncü taraf hizmetinin ne yaptığı, uygulamanın bu hizmetle nasıl etkileşimde bulunduğu açıklanır ve isteğe bağlı olarak ilgili web sitesine bağlantı verilir.
  • Kısa ve ayrıntılı açıklamalar anlaşılır.
  • Kısa ve ayrıntılı açıklamalar birbirinin aynı değil.
  • (Önerilen) Fiyatlandırma bilgileri eksiksiz ve doğrudur.
  • (Önerilen) Her dil (ad, kısa açıklama ve ayrıntılı açıklama) için tam özellik grubu, dil uyuşmazlığı olmadan doğru şekilde tanımlanır.
İşlevler
  • Belirgin hatalar yoktur ve uç durumlar dahil olmak üzere tüm işlemler tamamen işlevseldir. Yükleme süreleri, yükleme göstergeleriyle yönetilir.
  • Uygulama, Google API'leriyle net etkileşimler kuruyor.
  • Uygulama, Google ürünlerinde halihazırda bulunanlarla denk olmayan yeni veya genişletilmiş bir işlev sunuyor.
  • Uygulama, reklam veya spam amacıyla tasarlanmamıştır.
  • Uygulama tamamen işlevseldir ve test amacıyla tasarlanmamıştır. Şu anda devam eden bir çalışma değildir.
  • Uygulama, kullanıcıların veya ücretli kullanıcıların yararlanabileceği özelliklerle etkileşimde bulunursa Google'ın inceleme ekibi için geliştiricinin sisteminde bir test hesabı sağlanır.
Kullanıcı deneyimi
  • Uygulama, adı da dahil olmak üzere Google marka öğelerini, ticari markalarını veya Google markalı içeriğini kullanmaz. Google Workspace Marketplace markalama kurallarına bakın.
  • Yetkilendirme ve oturum açma yalnızca bir kez gereklidir. Uygulama, tek tıklamayla TOA veya ideal olarak sıfır tıklama ile TOA'yı kullanır.
  • Bir yönetici, alanda OAuth 2.0 kapsamları için izin verdikten sonra kullanıcılardan tek tek kapsam izinleri istenmez.
  • Kullanıcıların Google Hesaplarında oturum açtıktan sonra kimlik bilgilerini girmesi gerekmez. Erişim için en fazla "Google ile oturum aç" düğmesini tıklamaları gerekir.
  • Düğme etiketleri, menü öğeleri, başlıklar ve diğer uygulama öğeleri için tutarlı, net ve anlaşılır terimler vardır. Örneğin, evet veya hayır yerine etiketler, Sil ve İptal gibi işlem adlarına atıfta bulunur.
  • Oturum açmanız gerekiyorsa oturum kapatma işlevi düzgün çalışır. Jetonlar iptal edilir ve oturum açma işlemi baştan başlayabilir.
  • İşlemler için her zaman geri bildirim (ör. onay veya hata mesajları) gösterilir.
  • Bozuk resim bağlantıları veya bulanık resim olmamalıdır.
Grafik
  • Simgeler doğru boyutlandırılmış, kare ve şeffaf arka plana sahiptir. Grafik öğeleri konusuna bakın.
  • Simge, uygulamanın adını veya işlevini doğru bir şekilde temsil ediyor.
  • Simge renkli olmalıdır (gri tonlamalı değildir).
  • Simgede Google'ın ticari markaları kullanılmıyor.
  • Ekran görüntüleri ve resimler bulanık, okunması zor veya uygunsuz olmamalıdır. Uygulamayı doğru şekilde temsil etmelidir.
  • (Önerilen) Ekran görüntüleri, uygulamanın nasıl kullanılacağını ve ne işe yaradığını açıkça göstermektedir.
OAuth
  • Uygulama, OAuth doğrulamasını geçti, mümkün olan en dar OAuth kapsamlarını kullanıyor ve tüm kapsamlar, Google Hizmetleri API'leriyle doğru şekilde entegre oluyor.

Belirli uygulama entegrasyonları için ek şartlar

İlgili yorum ölçütlerini görüntülemek için uygulama girişinizde yer alan uygulama entegrasyonlarını seçin. Ölçütleri örneğin kategoriye göre sıralamak için sütun adlarını tıklayabilirsiniz.

Ön incelemenizi takip etmek için onay kutularını kullanabilirsiniz.

Uygulama entegrasyonu Kategori Ölçütler
Google Chat uygulaması Ad
  • Açıklamada, uygulamayla iletişim kurmak için kullanılacak düğmelere yer verilmiştir.
  • Uygulama adı A-Z (büyük harf) veya 0-9 ile başlar. Simgeyle başlayamaz.
Google Chat uygulaması Kullanıcı deneyimi
  • Bir kullanıcı doğrudan mesaj başlattığında veya uygulama bir alana eklendiğinde uygulama, istemde bulunulmadan bir karşılama mesajı gönderir. Karşılama mesajı, "Yardım" komutundan farklıdır. İyi bir karşılama mesajı oluşturma hakkında daha fazla bilgi için Kullanıcılara yardımcı olan ve onları memnun eden Chat uygulamaları geliştirme başlıklı makaleyi inceleyin.
  • Uygulama, "Yardım" komutunu destekler ve kullanıcıların uygulamayı kullanmaya başlamasına yardımcı olur. İyi bir yardım mesajı oluşturma hakkında daha fazla bilgi için Kullanıcılara yardımcı olan ve onları memnun eden Chat uygulamaları geliştirme başlıklı makaleyi inceleyin.
  • Uygulama, bir alanda veya doğrudan Chat ile konuşulduğunda her zaman yanıt verir.
  • İletilerde yazım, büyük harf kullanımı, noktalama ve dil bilgisi doğru kullanılmalıdır. İletiler kötü amaçlı, rahatsız edici veya kötüye kullanım amaçlı materyal içermez.
  • Mesajlarda, metin veya kartlar için Google'ın şartlarına uygun olarak net, kısa ve öz, tutarlı biçimlendirme kullanılı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 devre dışı bırakmasına olanak tanır.
  • Kullanıcılar @bahsetme özelliğini kullanarak uygulamayı bir alana ekleyebilirler.
  • Kullanıcılar, Üyeyi görüntüle menüsünü kullanarak uygulamayı bir alandan kaldırabilir.
  • Uygulama, etkileşimde bulunmak için gerekli olan her şeyi kullanıcıya bildiriyor.
  • Uygulamanın kullandığı kart biçimi, Google şartlarını karşılamaktadır. Etkileşimli kartlar oluşturma bölümünü inceleyin.
  • Uygulamaya, Chat menüsündeki Uygulama bul seçeneğinden erişilebilir.
  • Uygulamanın etkileşimde bulunduğu harici URL'ler, hazırlık veya geliştirme ortamına ait değildir.
  • Alanlarda uygulamaya gönderilen her mesajda @bahsetme gereklidir. Uygulamanın yanıt vermesi gerektiğini bilmesinin tek yolu budur.
  • Chat uygulaması, üçüncü taraf alanındaki bağlantıları önizlerse:
    • Bağlantı önizlemeleri, kullanıcının mesajıyla 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 Önizleme bağlantıları bölümünü inceleyin.

  • (Önerilir) Workspace yöneticilerinin kuruluşlarındaki kullanıcılar adına uygulamanızı yüklemesine izin vermek için uygulamanızın doğrudan mesaj alıp gönderebilmesi gerekir.
Google Chat uygulaması Grafik
  • Uygulamanın tanınabilir ve net bir avatarı var.
Google Drive uygulaması İşlevler
  • Uygulama, işlevselliği sağlamak için doğrudan Drive HTML'sini değiştirerek Chrome tarayıcı uzantılarını kullanmıyor.
  • Uygulamanız hassas veya kısıtlanmış kapsamlar kullanıyorsa OAuth doğrulamasından geçmelidir. Doğrulama için nasıl gönderebilirim? konusuna bakın.
  • Uygulamanız kısıtlanmış kapsamlar kullanıyorsa bir güvenlik değerlendirmesinden de geçmelidir. Güvenlik değerlendirmesi neden gerekli? bölümünü inceleyin.
Google Drive uygulaması Kullanıcı deneyimi
  • 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, kullanıcının Drive'ım klasörüne dosya dökümü yapmaz.
  • Uygulama, yalnızca uygulamanın belirtilen işlevine bağlı dosyaları Drive'da depolar.
Düzenleyici eklentisi İşlevler
  • Beklenen ve gerekli işlemler, eklentinin yanı sıra iş akışını tamamlamak için gereken tüm araçları da sağlar. Örneğin:
    • Eklenti, stili tüm dokümana uyguluyorsa stili yalnızca seçili metne uygulama seçeneği sunar.
    • 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 hesabı yoksa kolayca hesap oluşturabilmesi için bağlantılar veya bilgiler sağlar.
  • Eklentinin, eklentiler sekmesinde menü öğeleri vardır.
  • Eklenti yalnızca özel işlevler olsa bile uygun dokümanları içerir.
  • Eklenti, menüsünü doldurmak için doğru şekilde onInstall() ve onOpen() kullanıyor. Menü öğeleri, eklenti ilk kez yüklendiğinde ve farklı bir dosya açıldığında doldurulur. Düzenleyici Eklentisi yetkilendirmesi bölümünü inceleyin.
  • Yetkilendirme modları doğru ayarlanmış. Yetkilendirme modları sayfasını inceleyin.
Düzenleyici eklentisi Kullanıcı deneyimi
  • Eklenti, ürüne ve ürünün nasıl kullanılacağına dair temel bir anlayışa sahip olmak için gereken tüm bilgileri sağlar.
  • Eklenti kodu, kitaplıkları çok fazla kullanmaz. Kitaplıklar, eklentinin performansını kaybetmesine neden olabilir.
  • Mümkünse hatalardan kaçınılır ve doğru şekilde yönetilmez:
    • Hata mesajları, JavaScript uyarısında veya varsayılan kırmızı çubukta değil, bir iletişim penceresinde görüntülenir. Basit bir dil kullanarak sorunu iletir ve kullanıcının sorunu çözmek için ne yapması gerektiğini açıklar.
    • Mümkün olduğunda, kullanıcı yanlış bir şey yaptığında sorunu düzelten bir düğme görüntülenir.
    • Daha fazla bilgi için eklenti stil kılavuzuna bakın.
  • Harici sayfaların bağlantıları yeni pencerelerde açılır ve doğrudur.
  • Eklenti, sezgisel ve iyi tasarlanmış bir eklentidir. Bunun anlamı şudur:
    • Ne yapacağınız ve nasıl yapılacağı her zaman açıktır.
    • Eklenti erişilebilir ve anlaşılması kolaydır. Teknik terimler ve jargon kullanmaktan kaçının.
    • İş akışları nettir ve mümkün olduğunca kolaylaştırılmıştır.
    • Kullanıcı ve içeriği mümkün olduğunca güvenlidir.
  • Eklenti, düzenleyici eklentileri için kullanıcı arayüzü stil kılavuzunu izler ve düzenleyici eklentileri için CSS paketini kullanır.
  • Eklenti, ekran başına yalnızca bir mavi birincil işlem kullanır.
  • Eklenti aynı anda bir iletişim kutusu gösterir. Çakışma olmaz veya aynı anda birden fazla iletişim kutusu açık olur.
  • Eklentinin kullanıcı arayüzü, ayrılan alanlara düzgün bir şekilde sığar:
    • Metin ve etiketler "..." ifadesiyle kesilmez
    • Kullanıcının çok fazla dikey kaydırma yapması gerekmez.
    • İçerik genişliği 300p'yi aşmadığından yatay kaydırma çubuğu bulunmaz.
  • Eklenti onay gerektirir veya tüm hassas işlemler için uyarılar gösterir. Ö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 gereksinimi önleyebilirsiniz. Örneğin, verileri içe aktaran bir Google E-Tablolar eklentisi mevcut içeriğin üzerine yazma riski oluşturabilir. Varsayılan işlem olarak veriler için bir sayfa oluşturarak riski kaldırabilirsiniz.

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

Takvim eklentileri

  • Eklenti, calendar.name veya common.name kullanıyorsa manifest'teki ad, uygulama girişinde sağlanan adla aynı olur.
  • Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümü adı, "Google Takvim"i içermez.
  • (Önerilen) Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümü adı 30 karakteri aşmaz.
Google Workspace Eklentisi İşlevler
  • Eklenti, istenen işlev için doğru widget'ları kullanır. Örneğin, bir boole değeri seçmek için anahtar kullanın.

Takvim eklentileri

  • İkincil takvimler ve yetki verme desteklenir veya desteklenmiyorsa sorunsuz bir şekilde yönetilir. Örneğin, kullanıcı bir etkinlik oluştururken düzenleme erişimine sahip olduğu farklı bir takvimi seçerse konferans oluşturma işlemi başarısız olmaz.
  • Düzenli etkinlikler düzgün çalışır.
  • Eklenti calendar.conferenceSolution kullanı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 diğer desteklenen özellikler yapılandırılmış veri alanları kullanır ve notlar alanında sağlanmaz.
  • Eklenti, konferans çözümleri sağlıyorsa yalnızca konferans ayrıntılarını düzenler, diğer etkinlik alanlarını düzenlemez.
  • Eklenti, konferans çözümleri sağlıyorsa 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ş.
  • Yol boş değil. Örneğin, https://altostrat/ sorun çıkarmaz, ancak https://altostrat uygun değildir.
  • UrlFetchApp içinde joker karakter kullanılamaz.
Google Workspace Eklentisi Kullanıcı deneyimi
  • Eklentinin bir ana sayfası vardır. Google Workspace Eklentiniz dönüştürülmüş bir Gmail eklentisiyse varsayılan ana sayfa uygulanır.
  • Eklenti kartı düzgün çalışıyor. Örneğin, yinelenen kartlar yoktur; geri, yenile ve güncelle düğmeleri uygun şekilde çalışır.
  • Kullanıcı eklentiyi yetkilendirdikten sonra, kullanıcıyı oturum açma düğmesi (gerekirse), logo ve eklentinin kısa bir açıklamasını içeren özelleştirilmiş bir ana sayfa kartı görüntüler.
    • Oturum açma düğmesi tetiklenirse bu düğme, üçüncü taraf tedarikçi firmanın Google Workspace dışında çalışan bir üçüncü taraf hizmeti olduğunu açıkça belirten özelleştirilmiş bir oturum açma sayfası sunar.
  • 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 300p'yi aşmaz. Bu yüzden yatay kaydırma çubuğu bulunmaz.
  • Kitaplıklar, eklentinin performansını kaybetmesine neden olabileceğinden eklentinin kodu kitaplıkları çok fazla kullanmaz.

Takvim eklentileri

  • Eklenti, konferans çözümleri sağlıyorsa oluşturulan konferanslar geçerlidir ve üçüncü taraf konferans web sitesinde doğru şekilde gösterilir.

Dokümanlar eklentileri

Eklenti, üçüncü taraf alanından (akıllı çipler) gelen bağlantıları önizlerse:

  • Bağlantı önizlemeleri, kullanıcıya 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ı akıllı çiplerle önizleme bölümüne göz atın.

Drive eklentileri

  • 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, kullanıcının Drive'ım klasörüne dosya dökümü yapmaz.
  • Eklenti yalnızca eklentinin belirtilen işlevine bağlı olan dosyaları Drive'da depolar.

Gmail eklentileri

  • Eklenti, gerekçe göstermeden Chrome Tarayıcı uzantılarından bahsedmiyor veya bu uzantılara bağlantı vermiyor.
  • Diğer işlemler menüsü, düzgün çalışan evrensel işlemleri içerir. Örneğin, Oturumu Kapat, Hakkında, Destek vb.
Google Workspace Eklentisi Grafik

Takvim eklentileri

  • Konferans çözümünün logosu herkese açık bir URL'dir. Konferans çözümü logolarını sağlama bölümüne bakın.
  • Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümünün logosu, calendar.logoUrl gereksinimlerine uyar. Takvim manifest kaynağı bölümüne bakın.
  • Eklenti calendar.logoUrl veya common.logoUrl kullanıyorsa logo, uygulama girişinde sağlanan simgeyle aynı olur.
  • Eklenti calendar.logoUrl veya common.logoUrl kullanıyorsa logonun URL'si şu şekilde başlar: https://lh3.googleusercontent.com/
Google Workspace Eklentisi OAuth

Drive eklentileri

  • (Önerilen) Sınırlı meta veriler almak istiyorsanız eklenti, drive.addons.metadata.readonly kapsamını içerir.
Web uygulaması İşlevler
  • Evrensel gezinme URL'si bir web uygulamasına yönlendiriyor. İşlevi olmayan basit bir web sayfası, web uygulaması olarak kabul edilmez.