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

• Uygulamayla iletişim kurma düğmeleri açıklamada yer alır.
• 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. Hoşgeldin mesajı, "Yardım" komutundan farklıdır. Daha fazla bilgi için Google Chat uygulaması için ana sayfa oluşturma başlıklı makaleyi inceleyin.
• 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 başlıklı makaleyi inceleyin.
• Uygulama, alanda veya doğrudan Chat'te kendisine seslenildiğinde her zaman yanıt verir.
• Mesajlarda yazım, büyük harf kullanımı, noktalama ve dil bilgisi kurallarına uyulmalıdır. Mesajlarda kötü amaçlı, rahatsız edici veya taciz edici içerikler bulunmamalıdır.
• 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, @bahsetme ö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ı 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 geçmelidir. Güvenlik değerlendirmesi neden gereklidir? başlıklı makaleyi inceleyin.

• Uygulama, Drive'da dosya depolıyorsa kullanıcıların bir 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, 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'in bağlantısı eklenir.
  • 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 vardır.
• Eklenti yalnızca özel işlevlerden oluşsa bile uygun dokümanları içermelidir.
• Eklenti, menüsünü doldurmak için onInstall() ve onOpen() öğelerini 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ı düşürebileceğinden eklenti kodu kitaplıkları aşırı şekilde kullanmamalıdır.
• 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 kutusunda 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ış. Bunun anlamı şudur:
  • Ne yapılması gerektiği ve nasıl yapılacağı her zaman nettir.
  • Eklenti erişilebilir ve anlaşılması kolay olmalıdır. Teknik terimler ve jargondan kaçınılır.
  • İş akışları mümkün olduğunca net ve kolaylaştırılmış olmalıdır.
  • Kullanıcı ve içeriği 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 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'yi aşmaz. Böylece yatay kaydırma çubuğu olmaz.
• 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, 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 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

• Eklentide calendar.name veya common.name kullanılıyorsa manifest'teki ad, uygulama girişinde sağlanan adla aynı olmalıdır.
• Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümü adı "Google Takvim" içermez.
• (Önerilen) Eklenti calendar.conferenceSolution kullanıyorsa konferans çözümü adı 30 karakteri aşmamalıdır.

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

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ğil. Örneğin, https://altostrat/ kabul edilir ancak https://altostrat kabul edilmez.
• UrlFetchApp içinde joker karakterler kullanılamaz.

Meet eklentileri

• Üçüncü taraf çerezleri devre dışı bırakılsa 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 ayarı, ortak çalışma eklentisi 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.
• Eklenti, oturum açma ve etkinlik deneyimini ayarlamak için bir yan panel sağlamalıdır.
• Eklenti, bot davet etme işlevi sağlamamalı veya toplantıda bot varlığını temel almamalıdır

• 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 eklentilerindeki iframe'li kullanıcı arayüzü) düzgün ç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 şekilde sığar:
  • Metin ve etiketler "..." ile kesilmez.
  • Kullanıcının çok fazla dikey kaydırma yapması gerekmez.
  • İçerik genişliği 300 p'yi aşmamalıdır. Aksi takdirde yatay kaydırma çubuğu olur.
• Kitaplıklar, eklentinin performansını düşürebileceğinden eklentinin kodunda kitaplıklar aşırı ölçüde kullanılmamalıdır.

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 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 başlıklı makaleyi inceleyin.

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, dosyaları kullanıcının Drive'ım klasörüne aktarmaz.
• Eklentinin Drive'da sakladığı dosyalar yalnızca eklentinin belgelenmiş işleviyle bağlantılı olmalıdır.

Gmail eklentileri

• Eklentinin, Chrome tarayıcı uzantılarından bahsetmesi veya bu uzantılara bağlantı vermesi için geçerli bir gerekçesi yok.
• 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 olmaması gerekir.
• 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ı 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.
• Eklentide calendar.logoUrl veya common.logoUrl kullanılıyorsa logo, uygulama girişinde sağlanan simgeye aynıdır.
• Eklenti calendar.logoUrl veya common.logoUrl kullanıyorsa logonun URL'si şu şekilde başlar: https://lh3.googleusercontent.com/

Meet eklentileri

• Eklentinin marka logosu, Meet yan panelinde görülebilecek şekilde boyutlandırılmalı ve biçimlendirilmelidir.
• Uygun koyu mod logo URL'leri eklenti manifest dosyasında 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.