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

Bir uygulamayı Google Workspace Marketplace'te herkese açık olarak yayınlamak için Google, uygulamanızı ve uygulama girişini inceleyerek bunların Google'ın tasarım, içerik ve stil yönergelerine uygun olduğundan emin olur.

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

  • Uygulamanız için ek çalışma gerekiyorsa: Nelerin iyileştirilmesi gerektiği hakkında belirli 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 size bir bildirim e-postası gönderilir.

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

İnceleme süresi

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

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

Uygulamaları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 ayarlanır.
  • Uygulama OAuth doğrulamasını tamamlamadı.

Uygulama girişi sorunları:

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

Uygulama hazırlık durumu:

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

Ölçütleri inceleyin

Uygulamanızı incelemeye göndermeden önce tüm şartları karşıladığından 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şiyor.
  • Ad belirsiz veya çok genel değil.
  • Ad en fazla 50 karakterden oluşmalıdır.
  • (Önerilen) Ad, ilk harfleri büyük olacak şekilde kullanır.
  • (Önerilir) Ad, özellikle parantez için noktalama işareti içermiyor.
Geliştirici bilgileri
  • Geliştirici adı ve geliştirici web sitesi, geliştiriciyle ilgili bilgileri doğru şekilde temsil eder ve bu bilgilere yönlendirir.
  • Tüketici koruma yasaları nedeniyle Avrupa Ekonomik Alanı'nda (AEA) bulunan tüketiciler, Google Workspace Marketplace'teki bir satıcının tacir mi yoksa tacir olmayan mı olduğu konusunda bilgilendirilmelidir:
    • Tacir: Tacir; bir ticaret, işletme, zanaat veya meslekle ilgili amaçlarla ya da tacir adına veya adına hareket eden kişidir.
    • Tacir 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 "Tacir durumu belirtilmedi" ifadesi görünür.

Uygulama açıklaması
  • Sağlanan tüm bağlantılar çalışır ve doğru bilgilere yönlendirir. Örneğin, bir gizlilik politikası bağlantısı, gizlilik politikasının açıklandığı bir sayfaya yönlendirir.
  • Uygulama bir üçüncü taraf hizmetiyle etkileşime girerse açıklamada üçüncü taraf hizmetinin ne yaptığı, uygulamanın onunla 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 birbiriyle aynı değil.
  • (Önerilir) Fiyatlandırma bilgileri eksiksiz ve doğrudur.
  • (Önerilen) Her dil için özellik grubunun tamamı (ad, kısa açıklama ve ayrıntılı açıklama), dil uyuşmazlığı olmadan doğru şekilde tanımlanır.
İşlevler
  • Belirgin bir hata yok ve uç durumlar dahil tüm işlemler tamamen işlevsel. Yükleme süreleri, yükleme göstergeleriyle yönetilir.
  • Uygulama, Google API'leriyle net etkileşimler gösteriyor.
  • Uygulama, Google ürünlerinde halihazırda bulunanlarla eşdeğer olmayan yeni veya genişletilmiş bir işlev sağlıyor.
  • Uygulamanın amacı reklam veya spam yapmak değildir.
  • Uygulama tamamen çalışır durumdadır ve test amaçlı değildir. Devam eden bir çalışma değildir.
  • Uygulama, kullanıcıların veya ücretli kullanıcıların erişebildiği özelliklerle etkileşimde bulunursa Google'ın inceleme ekibine, geliştiricinin sisteminde bir test hesabı sağlanır.
Kullanıcı deneyimi
  • Uygulama, adı da dahil olmak üzere Google marka varlıklarını, ticari markalarını veya Google markalı içeriklerini kullanmıyor. Google Workspace Marketplace markalama kurallarına göz atı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ıklamalı TOA kullanır.
  • Bir yönetici, alan için OAuth 2.0 kapsamlarına yönelik izinler verdikten sonra kullanıcılardan kapsam izinleri tekrar istenmez.
  • Kullanıcıların Google Hesaplarında oturum açtıktan sonra kimlik bilgilerini girmeleri 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ı, bariz ve anlaşılır terimler vardır. Örneğin, Evet veya Hayır yerine etiketler Sil ve İptal gibi işlem adlarını ifade eder.
  • Oturum açmak gerekiyorsa oturum kapatma işlevi düzgün çalışır. Jetonlar iptal edilir ve oturum açma işlemi baştan başlanabilir.
  • İşlemler için her zaman onay veya hata mesajı gibi geri bildirim gösterilir.
  • Bozuk resim bağlantısı veya bulanık resim bulunmuyor.
Grafik
  • Simgeler doğru büyüklükte, kare şeklinde ve şeffaf arka plana sahip. Grafik öğeler bölümüne bakın.
  • Simge, uygulamanın adını veya işlevini doğru bir şekilde temsil ediyor.
  • Simge renkli olmalıdır (gri ölçeklenmiş değil).
  • Simgede Google'ın ticari markaları kullanılmıyor.
  • Ekran görüntüleri ve görseller bulanık, okunması zor veya uygunsuz olmamalıdır. Uygulamayı doğru şekilde temsil ediyorlar.
  • (Önerilir) Ekran görüntüleri, uygulamanın nasıl kullanılacağını ve ne işe yaradığını net bir şekilde gösterir.
OAuth
  • Uygulama OAuth doğrulamasını geçti, mümkün olan en dar OAuth kapsamlarını kullanıyor ve tüm kapsamlar Google Services API'leriyle doğru şekilde entegre oluyor.

Belirli uygulama entegrasyonları için ek koşullar

İlgili inceleme ölçütlerini görüntülemek için uygulama girişinize dahil edilen uygulama entegrasyonlarını seçin. Ölçütleri (örneğin, kategoriye göre) sıralamak için sütun adlarını tıklayabilirsiniz.

Ö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 almaktadır.
  • Uygulama adı A-Z (büyük harf) veya 0-9 ile başlar. Simgeyle başlayamaz.
Google Chat uygulaması Kullanıcı deneyimi
  • Kullanıcı doğrudan mesaj başlattığında veya bir alana uygulama eklendiğinde, uygulama 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 konusuna 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 konuşulduğunda 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'da metin veya kartlar için Google koşulları doğrultusunda net, kısa ve tutarlı bir 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 kapatmasını sağlar.
  • Kullanıcılar @bahis özelliğini kullanarak uygulamayı bir alana ekleyebilir.
  • Kullanıcılar, Üyeyi görüntüle menüsünü kullanarak uygulamayı bir alandan kaldırabilir.
  • Uygulama, kullanıcıya onunla etkileşimde bulunmak için gereken her şeyi gösteriyor.
  • Uygulamanın kullandığı kart biçimi, Google koşullarını karşılamalıdır. Etkileşimli kartlar oluşturma bölümüne bakın.
  • 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ğildir.
  • Alanlarda uygulamaya gönderilen her mesajda @bahsetme gereklidir. Ancak bu şekilde uygulama yanıt vermesi gerektiğini bilir.
  • Chat uygulaması, üçüncü taraf bir alandan gelen 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ını önizlediğinizde hesap, tutar ve aşama gibi bilgiler eklenir.
    • Geliştirici, önizlenen alanla ilişkilendirilmiş.

    Daha fazla bilgi için Önizleme bağlantıları konusuna bakın.

  • (Ö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 alabilmesi ve gönderebilmesi gerekir.
Google Chat uygulaması Grafik
  • Uygulamanın net ve anlaşılır bir avatarı var.
Google Drive uygulaması İşlevler
  • Uygulama, işlevsellik sağlamak için Drive HTML'sini doğrudan 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 başvuru yapabilirim? başlıklı makaleyi inceleyin.
  • Uygulamanız kısıtlanmış kapsamları kullanıyorsa ayrıca güvenlik değerlendirmesinden geçmelidir. Güvenlik değerlendirmesi neden gerekli? bölümüne göz atın.
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 aktarmaz.
  • Uygulama, Drive'da yalnızca uygulamanın belgelenen işlevine bağlı dosyaları depolar.
Düzenleyici Eklentisi İşlevler
  • Beklenen ve gerekli işlemler eklentiye dahildir. Ayrıca, iş akışını tamamlamak için gereken tüm araçları sağlar. Örneğin:
    • Eklenti, stili dokümanın tamamına uygularsa 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 hesabının olmasını gerektiriyorsa kullanıcının hesabı yoksa kolayca hesap oluşturmak için kullanılabilecek bağlantılar veya bilgiler sağlar.
  • Eklentinin eklentiler sekmesinde menü öğeleri bulunur.
  • Eklenti yalnızca özel işlevlerden oluşsa bile gerekli dokümanları içerir.
  • Eklenti, menüsünü doldurmak için onInstall() ve onOpen() özelliklerini doğru bir şekilde kullanıyor. Eklenti ilk yüklendiğinde ve farklı bir dosya açıldığında menü öğeleri doldurulur. Düzenleyici Eklentisi yetkilendirmesi bölümünü inceleyin.
  • Yetkilendirme modları doğru şekilde ayarlandı. Yetkilendirme modları bölümünü inceleyin.
  • Eklenti, Apps Komut Dosyası'nın V8 çalışma zamanına uygulanmalıdır. Daha fazla bilgi için V8 çalışma zamanına genel bakış konusuna bakın.
Düzenleyici Eklentisi Kullanıcı deneyimi
  • Eklenti, ürüne ve nasıl kullanılacağına dair temel bilgiler edinmek için gerekli tüm bilgileri sağlar.
  • Kitaplıklar, eklentinin performansını kaybetmesine neden olabileceğinden eklenti kodu, kitaplıkları çok fazla kullanmaz.
  • Mümkünse hatalardan kaçınılır ve aşağıdaki durumlar geçerli değilse doğru şekilde yönetilir:
    • Hata mesajları, JavaScript uyarısında veya varsayılan kırmızı çubukta değil, bir iletişim penceresinde gösterilir. Basit bir dille sorunu iletir ve sorunu çözmek için kullanıcının yapması gerekenleri açıklar.
    • Mümkün olduğunda, kullanıcı yanlış bir şey yapıyorsa sorunu onlar için düzelten bir düğme gösterilir.
    • Daha fazla bilgi için eklenti stil kılavuzuna göz atın.
  • Harici sayfaların bağlantıları yeni pencerelerde açılıyor ve doğru.
  • Eklenti sezgisel ve iyi tasarlanmış. Bu ne anlama geliyor?
    • Ne yapılması ve nasıl yapılması gerektiği her zaman açıktır.
    • Eklenti, erişilebilir ve anlaşılması kolay bir eklentidir. Teknik terimlere ve jargondan kaçınılmalıdır.
    • İş akışları mümkün olduğunca net olmalı ve kolaylaştırılmalıdır.
    • Kullanıcı ve içerikleri mümkün olduğunca güvendedir.
  • Eklenti, düzenleyici eklentileri için kullanıcı arayüzü stil kılavuzundaki talimatları uygulayın ve düzenleyici eklentileri için CSS paketini kullanır.
  • Eklenti, her ekranda yalnızca bir mavi birincil işlem kullanır.
  • Eklenti, aynı anda bir iletişim kutusu gösterir. Bunlar çakışmaz veya aynı anda birden fazla iletişim kutusu açık olmaz.
  • Eklentinin kullanıcı arayüzü, ayrılan alanlara düzgün bir şekilde sığar:
    • Metin ve etiketler "..." ile kesilmemiş.
    • Kullanıcının çok fazla dikey kaydırma yapması gerekmez.
    • İçerik genişliği 300p'den fazla olmadığından yatay kaydırma çubuğu bulunmaz.
  • Eklenti, tüm hassas işlemler için onay gerektirir veya uyarılar gösterir. Örneğin, eklenti bir e-tablodaki tüm içeriğin üzerine yazmak üzereyse kullanıcı uyarılır ve gerçekleşmeden önce işlemi onaylar.

    Tasarım değişiklikleri yaparak bu durumu önleyebilirsiniz. Örneğin, verileri içe aktaran bir Google E-Tablolar eklentisi, mevcut içeriğin üzerine yazma riski oluşturur. Veriler için varsayılan işlem olarak bir sayfa oluşturarak riski ortadan kaldırabilirsiniz.

  • Kullanıcılar bir işlem yüklenirken işlemi birden fazla kez tetikleyemez. Örneğin, bir işlem yüklenirken düğmeler kapatılır veya gizlenir.
Google Workspace Eklentisi Ad

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.
  • (Önerilir) Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümü 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 yetkiler, desteklenir ya da desteklenmiyorsa sorunsuz bir şekilde yönetilir. Örneğin, kullanıcı 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 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, 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ğildir. Örneğin, https://altostrat/ uygundur, ancak https://altostrat değildir.
  • UrlFetchApp dilinde 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 bulunmaz. Geri, yenile ve güncelle düğmeleri buna uygun şekilde çalışır.
  • Kullanıcı eklentiyi yetkilendirdikten sonra, oturum açma düğmesi (gerekirse), logo ve eklentinin kısa açıklaması ile kullanıcıları karşılamak için özelleştirilmiş bir ana sayfa kartı gösterir.
    • Oturum açma düğmesi tetiklenirse üçü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ı 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 çok fazla dikey kaydırma yapması gerekmez.
    • İçerik genişliği 300p'den fazla olmadığından yatay kaydırma çubuğu bulunmaz.
  • Kitaplıklar, eklentinin performansını kaybetmesine neden olabileceğinden eklenti kodu, kitaplıkları çok fazla kullanmaz.

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, bir üçüncü taraf alanından bağlantıları önizleniyorsa (akıllı çipler):

  • 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şkilendirilmiş.

Daha fazla bilgi için Akıllı çiplerle bağlantıları önizleme bölümüne bakı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 aktarmaz.
  • Eklenti yalnızca eklentinin belgelenen işlevlerine bağlı dosyaları Drive'da depolar.

Gmail eklentileri

  • Eklentide, herhangi bir gerekçe sunmadan Chrome tarayıcı uzantılarından bahsedilmiyor veya uzantılara bağlantı verilmiyor.
  • 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 başlıklı makaleyi inceleyin.
  • Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümünün logosu, calendar.logoUrl şartlarına uyar. Takvim manifest kaynağı bölümüne göz atın.
  • 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/
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. İşlevi olmayan basit bir web sayfası, web uygulaması olarak kabul edilmez.