Google Workspace Marketplace ile ilgili 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şini inceleyerek Google'ın tasarım, içerik ve stil yönergelerine uyduğundan emin olur.

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

  • Uygulamanız ek çalışma gerektiriyorsa: İyileştirilmesi gerekenlerle ilgili bilgileri 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 işlemine 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ı:

  • Yanlış OAuth izin ekranı ayarlanmış. Örneğin, kullanıcı türü Dahili veya yayınlama durumu Test olarak ayarlanmış olabilir.
  • 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ına ait bağlantı 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 yansıtmıyor.

Uygulamanın hazırlık durumu:

  • Uygulama hâlâ test ediliyor ve kullanıma sunulmaya hazır değil.
  • Uygulamada hatalar var veya uygulama tam olarak çalışmıyor.

Ölçütleri inceleyin

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

Tüm uygulamalar için gereksinimler

Ön incelemenizi izlemek 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 çok genel olmamalıdır.
  • Ad en fazla 50 karakterden oluşmalıdır.
  • (Önerilir) Adın ilk harfleri büyük olmalıdır.
  • (Önerilir) Adda noktalama işareti, özellikle de parantez yoktur.
Geliştirici bilgileri
  • Geliştirici adı ve geliştirici web sitesi, geliştiriciyi doğru şekilde temsil edip geliştiriciyle alakalı bilgileri yönlendiriyor.
  • Tüketiciyi koruma yasaları uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) tüketiciler, Google Workspace Marketplace'teki bir satıcının tacir mi yoksa tacir olmayan mı olduğu konusunda bilgilendirilmelidir:
    • Tüccar - Tacir, bir ticaret, işletme, zanaat veya meslekle ilgili amaçlar ya da tacir adına veya tacir adına hareket eden kişidir.
    • Tüccar olmayan - Tacir 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ışır ve doğru bilgileri gösterir. Örneğin, bir gizlilik politikası bağlantısı, gizlilik politikasını açıklayan bir sayfaya yönlendirme yapar.
  • Uygulama bir üçüncü taraf hizmetiyle etkileşim kuruyorsa açıklamada üçüncü taraf hizmetinin ne yaptığı, uygulamanın bu hizmetle nasıl etkileşim kurduğ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 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 herhangi bir hata yoktur ve uç durumlar da dahil olmak üzere tüm işlemler tamamen işlevseldir. Yükleme süreleri, yükleme göstergeleriyle yönetilir.
  • Uygulamada, Google API'leriyle net etkileşimler gösteriliyor.
  • Uygulama, Google ürünlerinde mevcut olan özelliklere eşdeğer olmayan yeni veya genişletilmiş bir işlev sunuyor.
  • Uygulama, reklam veya spam yapmak için tasarlanmamıştır.
  • Uygulama tamamen işlevseldir ve test amaçlı değildir. Devam eden bir çalışma değildir.
  • Uygulama, kullanıcılara veya ücretli kullanıcılara sunulan özelliklerle etkileşimde bulunursa Google'ın inceleme ekibine geliştiricinin sistemindeki bir test hesabı sağlanır.
Kullanıcı deneyimi
  • Uygulama, adı da dahil olmak üzere Google marka varlıkları, ticari markalar veya Google markalı içerik kullanmaz. Google Workspace Marketplace markalama kurallarına bakın.
  • Yetkilendirme ve oturum açma işlemi yalnızca bir kez gereklidir. Uygulama, tek tıklamayla TOA veya ideal olarak sıfır tıklamayla TOA kullanır.
  • Bir yönetici, alan için OAuth 2.0 kapsamları için izinler verdikten sonra kullanıcılardan tek tek kapsam izinleri istenmez.
  • Kullanıcıların Google Hesaplarında oturum açtıktan sonra kimlik bilgilerini girmesine gerek yoktur. Erişmek 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ı, açık ve anlaşılabilir terimler vardır. Örneğin etiketler, Evet veya Hayır yerine Sil ve İptal gibi işlem adlarını ifade eder.
  • Oturum açılması gerekiyorsa oturum kapatma işlevi düzgün çalışıyor. Jetonlar iptal edilir ve oturum açma işlemi baştan başlayabilir.
  • İşlemler için her zaman geri bildirim gösterilir (ör. onay veya hata mesajı).
  • Bozuk resim bağlantıları veya belirsiz resim bulunmamalıdır.
Grafik
  • Simgeler doğru boyutlandırılmış, kare ve şeffaf arka plana sahip. Grafik öğeleri konusuna bakın.
  • Simge, uygulamanın adını veya işlevini düzgün bir şekilde yansıtıyor.
  • Simge renkli olmalıdır (gri ölçekli değil).
  • Simgede Google'ın ticari markaları kullanılmaz.
  • Ekran görüntüleri ve resimler bulanık, okunması zor veya uygunsuz olmamalıdır. Uygulamayı doğru şekilde temsil ederler.
  • (Önerilir) 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çmiştir, mümkün olan en dar OAuth kapsamlarını kullanır ve tüm kapsamlar, Google Hizmetleri API'leriyle doğru şekilde entegre olur.

Belirli uygulama entegrasyonları için ek şartlar

İlgili inceleme ölçütlerini görüntülemek için uygulama girişinizde yer alan uygulama entegrasyonlarını seçin. Sütun adlarını tıklayarak ölçütleri (örneğin, kategoriye göre) sıralayabilirsiniz.

Ön incelemenizi izlemek için onay kutularını kullanabilirsiniz.

Uygulama entegrasyonu Kategori Ölçütler
Google Chat uygulaması Ad
  • Uygulamayla iletişim kurmak için kullanılan düğmeler açıklamada yer alır.
  • Uygulama adı A-Z (büyük harf) veya 0-9 ile başlıyor. Simgeyle başlayamaz.
Google Chat uygulaması Kullanıcı deneyimi
  • Uygulama, bir kullanıcı doğrudan mesaj başlattığında veya bir alana her eklendiğinde istemsiz bir karşılama mesajı gönderir. Karşılama mesajı, "Yardım" komutundan farklıdır. Daha fazla bilgi için Uygulama ana kartı mesajı gönderme bölümüne göz atın.
  • Uygulama, "Yardım" komutunu destekliyor ve kullanıcıların uygulamayı kullanmaya başlamasına yardımcı oluyor. Daha fazla bilgi için Eğik çizgi komutlarını yanıtlama 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-küçük harf, noktalama ve dil bilgisi doğru olmalıdır. İletiler kötü amaçlı, rahatsız edici veya kötüye kullanım amaçlı materyal içermez.
  • Mesajlar, metin veya kartlar için Google'ın gereksinimlerine uygun açık, kısa ve tutarlı biçimlendirmeler 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 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 bulunmaları için gereken her şeyi kullanıcıya bildirir.
  • 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 bir hazırlık veya geliştirme ortamına ait değil.
  • Alanlarda uygulamaya gönderilen her mesajda @bahsetme zorunludur. Uygulamanın yanıt vermesi gerektiğini bilmesinin tek yolu budur.
  • Chat uygulaması, bir üçüncü taraf alanındaki bağlantıları önizlerse:
    • 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ı önizlendiğinde hesap, tutar ve aşama gibi bilgiler eklenir.
    • Geliştirici, önizlenen alan adıyla ilişkilidir.

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

  • (Önerilir) Workspace yöneticilerinin kuruluşlarındaki kullanıcılar adına uygulamanızı yükleyebilmesi 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, doğrudan Drive HTML'sini değiştirerek işlevsellik sağlamak için Chrome tarayıcı uzantılarını kullanmaz.
  • Uygulamanız hassas veya kısıtlanmış kapsamlar kullanıyorsa OAuth doğrulamasından geçmelidir. Doğrulama için nasıl gönderebilirim? bölümüne göz atın.
  • Uygulamanız kısıtlanmış kapsamlar kullanıyorsa güvenlik değerlendirmesinden de geçmelidir. Güvenlik değerlendirmesi neden gereklidir? bölümünü inceleyin.
Google Drive uygulaması Kullanıcı deneyimi
  • Uygulama, dosyaları Drive'da depoluyorsa kullanıcıların 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 belgelenen işlevine bağlı olan dosyaları Drive'da depolar.
Düzenleyici Eklentisi İşlevler
  • 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 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 ilgili feed'e bağlantı içerir.
    • Eklenti, kullanıcının bir hesaba sahip olmasını gerektiriyorsa, kullanıcının hesabı yoksa kolayca hesap oluşturması için bağlantılar veya bilgiler sağlar.
  • Eklentinin menü öğeleri, eklentiler sekmesinde yer alı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 Eklenti yetkilendirmesi bölümünü inceleyin.
  • Yetkilendirme modları doğru şekilde ayarlanmış. Yetkilendirme modları sayfasını inceleyin.
Düzenleyici Eklentisi Kullanıcı deneyimi
  • Eklenti, ürünle ve nasıl kullanılacağıyla ilgili temel bir anlayışa sahip olmanız için gereken tüm bilgileri sağlar.
  • Kitaplıklar eklentinin performansını kaybetmesine neden olabileceğinden eklenti kodu, kitaplıkları çok fazla kullanmaz.
  • Mümkünse hatalar önlenir ve doğru bir şekilde yönetilir:
    • 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 dille 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. Bu ne anlama geliyor?
    • Ne yapacağınız ve nasıl yapacağınız her zaman açıktır.
    • Eklenti, erişilebilir ve anlaşılması kolay. Teknik terimler ve jargon kullanmaktan kaçının.
    • İş akışları olabildiğince anlaşılır ve kolaylaştırılmış.
    • Kullanıcı ve içeriği mümkün olduğunca güvendedir.
  • Eklenti, düzenleyici eklentileri için kullanıcı arayüzü stil kılavuzunu takip eder ve düzenleyici eklentileri için CSS paketini kullanır.
  • Eklenti, görüntülü reklam başına yalnızca bir mavi birincil işlem kullanır.
  • Eklenti her defasında tek bir iletişim kutusu gösterir. Üst üste binmez 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 "..." ile kesilmez
    • Kullanıcının dikey kaydırma yapmak için fazla çaba sarf etmesi gerekmez.
    • İçerik genişliği 300p'yi aşmayacak şekilde yatay kaydırma çubuğu bulunmamalıdır.
  • 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ı alır ve işlemi gerçekleşmeden önce onaylar.

    Tasarım değişiklikleri yaparak bu gereksinimi önleyebilirsiniz. Örneğin, veri 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 e-tablo oluşturarak riski kaldırabilirsiniz.

  • Kullanıcılar, bir işlem yüklenirken işlemi 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ünün adı 30 karakteri aşmaz.
Google Workspace Eklentisi İşlevler
  • Eklenti, istenen işlevler 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 yetkilendirme desteklenir veya desteklenmiyorsa sorunsuz ş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 başarısız olmaz.
  • Düzenli etkinlikler düzgün çalışıyor.
  • 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 desteklenen diğer özellikler yapılandırılmış veri alanları kullanır ve notlar alanında sunulmaz.
  • 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 karakterler 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, özelleştirilmiş bir ana sayfa kartı görüntüler. Bu kartta kullanıcıyı bir oturum açma düğmesi (gerekirse), logo ve eklentinin kısa bir açıklaması yer alır.
    • Oturum açma düğmesi tetiklenirse Google Workspace dışında çalışan bir üçüncü taraf hizmeti olduğunu açıkça belirten, üçüncü taraf tedarikçi firmaya ait özelleştirilmiş bir oturum açma sayfası gösterilir.
  • Eklentinin kullanıcı arayüzü, ayrılan alanlara düzgün bir şekilde sığar:
    • Metin ve etiketler "..." ile kesilmiyor
    • Kullanıcının dikey kaydırma yapmak için fazla çabası yoktur.
    • İçerik genişliği 300p'yi aşmaz, bu nedenle yatay kaydırma çubuğu yoktur.
  • 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örüntülenir.

Dokümanlar eklentileri

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

  • Bağlantı önizlemeleri, kullanıcılara alakalı ve ek bilgiler sunar. Örneğin, bir satış anlaşmasının bağlantısı önizlendiğinde hesap, tutar ve aşama gibi bilgiler eklenir.
  • Geliştirici, önizlenen alan adıyla ilişkilidir.

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

Drive eklentileri

  • Uygulama, dosyaları Drive'da depoluyorsa kullanıcıların 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 belgelenen işlevlerine 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şlemler 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 göz atın.
  • Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümünün logosu calendar.logoUrl gereksinimlerine uygundur. Takvim manifest kaynağı sayfasını inceleyin.
  • 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

  • (Önerilir) 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ını işaret eder. İşlevselliği olmayan basit bir web sayfası, web uygulaması olarak kabul edilmez.