Proses peninjauan aplikasi dan persyaratan untuk Google Workspace Marketplace

Untuk memublikasikan aplikasi secara publik ke Google Workspace Marketplace, Google akan meninjau aplikasi Anda dan listingannya untuk memastikan aplikasi tersebut memenuhi panduan desain, konten, dan gaya Google.

Setelah Google meninjau aplikasi, Anda akan menerima email tentang apakah aplikasi memerlukan lebih banyak peningkatan atau apakah aplikasi disetujui.

  • Jika aplikasi Anda memerlukan pekerjaan tambahan—Anda akan menerima dokumen ulasan yang berisi informasi spesifik tentang hal yang perlu ditingkatkan. Atasi masalah dan kirim ulang aplikasi Anda untuk ditinjau.
  • Jika tim peninjau menyetujui aplikasi Anda—Aplikasi akan otomatis dipublikasikan dan Anda akan menerima email notifikasi.

Sebelum mengirimkan aplikasi untuk ditinjau, pastikan aplikasi Anda siap dipublikasikan. Untuk mengetahui detailnya, lihat Menyiapkan proses publikasi.

Durasi ulasan

Peninjauan aplikasi biasanya memerlukan waktu beberapa hari. Waktu yang diperlukan bergantung pada:

  • Jumlah aplikasi yang dikirim baru-baru ini
  • Berapa banyak pekerjaan tambahan yang dibutuhkan aplikasi Anda

Alasan umum aplikasi tidak lulus peninjauan

Verifikasi OAuth:

  • Penyiapan layar izin OAuth salah. Misalnya, jenis pengguna ditetapkan ke Internal atau status publikasi ditetapkan ke Pengujian.
  • Aplikasi tidak menyelesaikan verifikasi OAuth.

Masalah listingan aplikasi:

  • Penggunaan merek dagang Google yang tidak tepat dalam nama aplikasi, logo, atau deskripsi aplikasi. Sebagai panduan, buka pedoman branding Google Workspace Marketplace.
  • Link tidak berfungsi atau mengarah ke informasi yang salah. Misalnya, link kebijakan privasi mengarah ke halaman dukungan developer.
  • Screenshot dan gambar berkualitas rendah, atau tidak merepresentasikan fungsi aplikasi secara akurat.

Kesiapan aplikasi:

  • Aplikasi masih dalam tahap pengujian dan belum siap untuk umum.
  • Aplikasi memiliki bug atau tidak berfungsi sepenuhnya.

Tinjau kriteria

Sebelum mengirimkan aplikasi untuk ditinjau, pastikan aplikasi Anda memenuhi semua persyaratan dan mematuhi kebijakan program Google Workspace Marketplace.

Persyaratan untuk semua aplikasi

Anda dapat menggunakan kotak centang untuk melacak tinjauan awal.

Kategori Kriteria
Nama aplikasi
  • Tidak ada listingan aplikasi lain dengan nama yang sama.
  • Nama tidak menyertakan nomor versi.
  • Nama ini cocok dengan nama di layar izin OAuth.
  • Namanya tidak terlalu jelas atau terlalu umum.
  • Nama maksimal 50 karakter.
  • (Direkomendasikan) Nama menggunakan kapitalisasi judul.
  • (Direkomendasikan) Nama tidak memiliki tanda baca, terutama tanda kurung.
Informasi pengembang
  • Nama developer dan situs developer mewakili dan mengarahkan ke informasi yang relevan tentang developer secara akurat.
  • Berdasarkan hukum perlindungan konsumen, konsumen yang berada di Wilayah Ekonomi Eropa (EEA) harus diberi tahu apakah penjual di Google Workspace Marketplace adalah pedagang atau non-pedagang:
    • Pedagang—Pedagang adalah orang yang bertindak untuk tujuan yang berkaitan dengan perdagangan, bisnis, keterampilan, atau profesi; atau atas nama atau atas nama pedagang.
    • Non-pedagang—Non-pedagang (konsumen) adalah orang yang bertindak untuk tujuan non-profesional.

    Jika tidak ditentukan, "Status perdagangan belum ditentukan" akan muncul di halaman listingan Play Store aplikasi Anda.

Deskripsi aplikasi
  • Semua link yang diberikan berfungsi dan mengarah ke informasi yang benar. Misalnya, link untuk kebijakan privasi mengarah ke halaman yang menjelaskan kebijakan privasi.
  • Jika aplikasi berinteraksi dengan layanan pihak ketiga, deskripsinya menjelaskan fungsi layanan pihak ketiga, cara aplikasi berinteraksi dengannya, dan jika perlu, menautkan ke situs yang relevan.
  • Deskripsi singkat dan mendetail bisa dipahami.
  • Deskripsi pendek dan mendetailnya tidak sama.
  • (Direkomendasikan) Informasi harga lengkap dan akurat.
  • (Direkomendasikan) Kumpulan atribut lengkap per bahasa (nama, deskripsi singkat, dan deskripsi mendetail) ditentukan dengan benar tanpa ketidakcocokan bahasa.
Fungsi
  • Tidak ada bug yang jelas dan semua tindakan, termasuk kasus ekstrem, berfungsi sepenuhnya. Waktu pemuatan dikelola dengan indikator pemuatan.
  • Aplikasi menunjukkan interaksi yang jelas dengan Google API.
  • Aplikasi menyediakan fungsi baru atau tambahan yang tidak setara dengan yang sudah disertakan dalam produk Google.
  • Aplikasi ini tidak dimaksudkan untuk tujuan periklanan atau spamming.
  • Aplikasi berfungsi sepenuhnya dan tidak dimaksudkan untuk tujuan pengujian—bukan merupakan karya yang sedang dalam proses.
  • Jika aplikasi berinteraksi dengan fitur yang tersedia bagi pengguna atau pengguna berbayar, akun pengujian di sistem developer disediakan untuk tim peninjau Google.
Pengalaman pengguna
  • Aplikasi, termasuk namanya, tidak menggunakan aset merek, merek dagang, atau konten bermerek Google. Lihat pedoman branding Google Workspace Marketplace.
  • Otorisasi dan login hanya diperlukan satu kali. Aplikasi menggunakan SSO sekali klik atau idealnya SSO tanpa klik.
  • Setelah administrator memberikan izin cakupan OAuth 2.0 untuk domain, masing-masing pengguna tidak akan dimintai izin cakupan lagi.
  • Pengguna tidak perlu memasukkan kredensial setelah login ke Akun Google mereka. Biasanya, mereka harus mengklik tombol "Login dengan Google" untuk mendapatkan akses.
  • Ada istilah yang konsisten, jelas, dan mudah dipahami untuk label tombol, item menu, judul, dan elemen aplikasi lainnya. Misalnya, sebagai ganti Ya atau Tidak, label merujuk ke nama tindakan seperti Delete dan Cancel.
  • Jika login diwajibkan, fungsi logout akan berfungsi dengan baik. Token dicabut dan login dapat dimulai dari awal.
  • Masukan selalu ditampilkan, seperti pesan konfirmasi atau error, untuk tindakan.
  • Tidak ada link gambar yang rusak atau gambar kabur.
Grafis
  • Ikon memiliki ukuran yang tepat, berbentuk persegi, dan memiliki latar belakang transparan. Lihat Aset visual.
  • Ikon dengan tepat mewakili nama atau fungsi aplikasi.
  • Ikon berwarna (bukan berwarna abu-abu).
  • Ikon tidak menggunakan merek dagang Google.
  • Screenshot dan gambar tidak buram, sulit dibaca, atau tidak pantas. Keduanya mewakili aplikasi secara akurat.
  • (Direkomendasikan) Screenshot dengan jelas menunjukkan cara menggunakan aplikasi dan fungsinya.
OAuth
  • Aplikasi telah lulus verifikasi OAuth, menggunakan cakupan OAuth paling sempit, dan semua cakupan terintegrasi dengan benar dengan Google Services API.

Persyaratan tambahan untuk integrasi aplikasi tertentu

Pilih integrasi aplikasi yang disertakan dalam listingan aplikasi Anda untuk melihat kriteria peninjauan yang relevan. Anda dapat mengklik nama kolom untuk mengurutkan kriteria, misalnya, berdasarkan kategori.

Anda dapat menggunakan kotak centang untuk melacak tinjauan awal.

Integrasi aplikasi Kategori Kriteria
Aplikasi Google Chat Name
  • Tombol untuk berkomunikasi dengan aplikasi tersedia di deskripsi.
  • Nama aplikasi diawali dengan A—Z (huruf besar) atau 0–9. Tidak boleh diawali dengan simbol.
Aplikasi Google Chat Pengalaman pengguna
  • Aplikasi mengirim pesan selamat datang tanpa perintah setiap kali pengguna memulai pesan langsung atau aplikasi ditambahkan ke ruang. Pesan selamat datang berbeda dengan perintah "Help". Untuk informasi selengkapnya, lihat Mengirim pesan kartu utama aplikasi.
  • Aplikasi ini mendukung perintah "Bantuan" dan membantu pengguna mulai menggunakan aplikasi. Untuk informasi selengkapnya, lihat Merespons perintah garis miring.
  • Aplikasi selalu merespons saat diajak bicara di ruang atau Chat langsung.
  • Pesan menggunakan ejaan, huruf besar, tanda baca, dan tata bahasa yang benar. Pesan tidak berisi materi yang berbahaya, menyinggung, atau melanggar.
  • Pesan menggunakan format yang jelas, ringkas, dan konsisten untuk teks atau kartu sesuai dengan persyaratan Google.
  • Jika respons memerlukan waktu lebih dari 2 detik, aplikasi akan mengirimkan pesan yang menjelaskan penundaan tersebut.
  • Aplikasi yang mengirim notifikasi memungkinkan pengguna menonaktifkan notifikasi.
  • Pengguna dapat menambahkan aplikasi ke ruang menggunakan @sebutan.
  • Pengguna dapat menghapus aplikasi dari ruang menggunakan menu Lihat anggota.
  • Aplikasi menunjukkan kepada pengguna semua yang diperlukan untuk berinteraksi dengannya.
  • Format kartu yang digunakan aplikasi memenuhi persyaratan Google. Lihat Membuat kartu interaktif.
  • Aplikasi ini tersedia dari opsi Temukan aplikasi dalam menu Chat.
  • URL eksternal yang berinteraksi dengan aplikasi bukan bagian dari lingkungan staging atau pengembangan.
  • @sebutan diperlukan di setiap pesan untuk aplikasi dalam ruang. Hanya cara ini yang membuat aplikasi tahu bahwa aplikasi harus merespons.
  • Jika aplikasi Chat melihat pratinjau link dari domain pihak ketiga:
    • Pratinjau link menawarkan informasi tambahan yang relevan dengan pesan pengguna. Misalnya, melihat pratinjau link ke penawaran penjualan akan menambahkan informasi seperti rekening, jumlah, dan tahapan.
    • Developer berafiliasi dengan domain yang dipratinjau.

    Untuk informasi selengkapnya, lihat Pratinjau link.

  • (Direkomendasikan) Agar administrator Workspace dapat menginstal aplikasi Anda atas nama pengguna di organisasi mereka, aplikasi Anda harus dapat menerima dan mengirim pesan langsung.
Aplikasi Google Chat Grafis
  • Aplikasi memiliki avatar yang mudah dikenali dan jelas.
Aplikasi Google Drive Fungsi
  • Aplikasi tidak menggunakan ekstensi browser Chrome untuk menyediakan fungsi dengan memanipulasi HTML Drive secara langsung.
  • Jika aplikasi Anda menggunakan cakupan sensitif atau yang dibatasi, aplikasi harus menjalani verifikasi OAuth. Lihat Cara mengirimkan permohonan verifikasi.
  • Jika aplikasi Anda menggunakan cakupan yang dibatasi, aplikasi juga harus melalui penilaian keamanan. Lihat Mengapa penilaian keamanan diperlukan.
Aplikasi Google Drive Pengalaman pengguna
  • Jika aplikasi menyimpan file di Drive, pengguna dapat memilih folder atau membuat dan menggunakan kembali folder khusus aplikasi. Data konfigurasi dapat disimpan di folder App Data. Aplikasi tidak membuang file ke folder Drive Saya milik pengguna.
  • Aplikasi hanya menyimpan file di Drive yang terhubung ke fungsi aplikasi yang terdokumentasi.
Add-on Editor Fungsi
  • Tindakan yang diharapkan dan diperlukan disertakan dalam add-on, dan menyediakan semua alat yang diperlukan untuk menyelesaikan alur kerjanya. Contoh:
    • Jika menerapkan gaya visual ke seluruh dokumen, add-on akan menawarkan opsi untuk menerapkan gaya hanya pada teks yang dipilih.
    • Jika add-on mengupload data spreadsheet ke feed layanan web, add-on akan memiliki link ke feed tersebut untuk memudahkan navigasi.
    • Jika mengharuskan pengguna memiliki akun, add-on akan menyediakan link atau info untuk membuat akun dengan mudah jika pengguna belum memilikinya.
  • Add-on memiliki item menu di bagian tab add-on.
  • Meskipun hanya berupa fungsi kustom, add-on tetap menyertakan dokumentasi yang sesuai.
  • Add-on ini menggunakan onInstall() dan onOpen() dengan benar untuk mengisi menunya. Item menu akan terisi saat add-on pertama kali diinstal dan saat file yang berbeda dibuka. Lihat Otorisasi Add-on Editor.
  • Mode otorisasi disiapkan dengan benar. Lihat Mode otorisasi.
  • Add-on harus diterapkan dalam runtime V8 Apps Script. Untuk mengetahui informasi selengkapnya, lihat ringkasan runtime V8.
Add-on Editor Pengalaman pengguna
  • Add-on ini memberikan semua informasi yang diperlukan untuk memiliki pemahaman dasar tentang produk dan cara menggunakannya.
  • Kode add-on tidak menggunakan library secara berlebihan karena library dapat menyebabkan add-on kehilangan performa.
  • Jika memungkinkan, error dapat dihindari dan dikelola dengan benar, jika tidak:
    • Pesan error ditampilkan dalam jendela dialog, bukan dalam peringatan JavaScript atau di panel merah default. Pernyataan masalah menyampaikan masalah dan menjelaskan tindakan yang harus dilakukan pengguna untuk memperbaikinya dengan bahasa sederhana.
    • Jika memungkinkan, jika pengguna melakukan kesalahan, sebuah tombol akan ditampilkan untuk memperbaiki masalah tersebut.
    • Untuk mengetahui informasi selengkapnya, lihat panduan gaya add-on.
  • Link ke halaman eksternal terbuka di jendela baru dan benar.
  • Add-on ini intuitif dan didesain dengan baik. Artinya:
    • Selalu jelas apa yang harus dilakukan dan bagaimana melakukannya.
    • Add-on ini dapat diakses dan mudah dipahami. Sebaiknya hindari istilah-istilah teknis dan jargon-jargon.
    • Alur kerja dibuat jelas dan difasilitasi semaksimal mungkin.
    • Pengguna dan konten mereka seaman mungkin.
  • Add-on ini mengikuti panduan gaya UI untuk add-on editor dan menggunakan paket CSS untuk add-on editor.
  • Add-on ini hanya menggunakan satu tindakan utama berwarna biru per layar.
  • Add-on menampilkan satu dialog dalam satu waktu. Tidak tumpang tindih atau ada beberapa dialog yang terbuka sekaligus.
  • UI add-on sangat cocok dalam ruang yang dialokasikan:
    • Teks dan label tidak terpotong dengan "..."
    • Pengguna tidak perlu melakukan banyak scroll vertikal.
    • Lebar konten tidak melebihi 300p sehingga tidak memiliki scrollbar horizontal.
  • Add-on ini memerlukan konfirmasi atau menampilkan peringatan untuk semua tindakan sensitif. Misalnya, jika add-on akan menimpa semua konten dalam spreadsheet, pengguna akan diperingatkan dan mengonfirmasi tindakan sebelum terjadi.

    Anda dapat menghindari persyaratan ini melalui perubahan desain. Misalnya, add-on Google Spreadsheet yang mengimpor data akan berisiko menimpa konten yang ada. Anda dapat menghapus risiko dengan membuat sheet untuk data sebagai tindakan default.

  • Pengguna tidak dapat memicu tindakan beberapa kali saat tindakan sedang dimuat. Misalnya, tombol dinonaktifkan atau disembunyikan saat tindakan dimuat.
Add-on Google Workspace Name

Add-on Kalender

  • Jika add-on menggunakan calendar.name atau common.name, nama dalam manifes sama dengan nama yang diberikan dalam listingan aplikasi.
  • Jika add-on menggunakan calendar.conferenceSolution, nama solusi konferensi tidak berisi “Google Kalender”.
  • (Direkomendasikan) Jika add-on menggunakan calendar.conferenceSolution, nama solusi konferensi tidak boleh melebihi 30 karakter.
Add-on Google Workspace Fungsi
  • Add-on ini menggunakan widget yang tepat untuk fungsi yang diinginkan. Misalnya, gunakan tombol untuk memilih nilai boolean.

Add-on Kalender

  • Delegasi dan kalender sekunder didukung, atau jika tidak didukung, dikelola dengan baik. Misalnya, pembuatan konferensi tidak gagal jika pengguna memilih kalender lain yang akses editnya mereka miliki saat membuat acara.
  • Acara rutin berfungsi dengan baik.
  • Jika add-on menggunakan calendar.conferenceSolution, setidaknya satu solusi konferensi disediakan.
  • Jika add-on menyediakan solusi konferensi, kolom data konferensi yang sesuai akan digunakan. Misalnya, link konferensi video, nomor telepon, link SIP, kode akses, dan atribut yang didukung lainnya menggunakan kolom data terstruktur dan tidak disediakan di kolom catatan.
  • Jika memberikan solusi konferensi, add-on hanya mengedit detail konferensi, bukan kolom acara lainnya.
  • Jika add-on menyediakan solusi konferensi, pembuatan konferensi akan memerlukan waktu kurang dari 5 detik.

Add-on Gmail

Jika add-on menggunakan UrlFetchApp atau OpenLinkUrl:

  • URL valid.
  • URL menggunakan HTTPS, bukan HTTP.
  • Domain lengkap telah ditentukan.
  • Jalur tidak kosong. Misalnya, https://altostrat/ tidak masalah, tetapi https://altostrat tidak.
  • Karakter pengganti tidak dapat digunakan di UrlFetchApp.
Add-on Google Workspace Pengalaman pengguna
  • Add-on memiliki halaman beranda. Jika Add-on Google Workspace Anda adalah add-on Gmail yang dikonversi, halaman beranda default akan diterapkan.
  • Kartu add-on berfungsi dengan baik. Misalnya, tidak ada kartu duplikat; tombol kembali, muat ulang, dan perbarui berfungsi sebagaimana mestinya.
  • Setelah pengguna mengizinkan add-on, add-on akan menampilkan kartu halaman beranda yang disesuaikan untuk menyambut pengguna dengan tombol login (jika diperlukan), logo, dan deskripsi singkat add-on.
    • Jika dipicu, tombol login akan menampilkan halaman login yang disesuaikan dari vendor pihak ketiga yang secara jelas menunjukkan bahwa ada layanan pihak ketiga yang bekerja di luar Google Workspace.
  • UI add-on sangat cocok dalam ruang yang dialokasikan:
    • Teks dan label tidak terpotong dengan "..."
    • Pengguna tidak perlu melakukan banyak scroll vertikal.
    • Lebar konten tidak melebihi 300p sehingga tidak memiliki scrollbar horizontal.
  • Kode add-on tidak menggunakan library secara berlebihan karena library dapat menyebabkan add-on kehilangan performa.

Add-on Kalender

  • Jika add-on menyediakan solusi konferensi, konferensi yang dibuat valid dan ditampilkan dengan benar di situs konferensi pihak ketiga.

Add-on Dokumen

Jika add-on melihat pratinjau link dari domain pihak ketiga (smart chip):

  • Pratinjau link menawarkan informasi tambahan yang relevan kepada pengguna. Misalnya, melihat pratinjau link ke penawaran penjualan akan menambahkan informasi seperti rekening, jumlah, dan tahapan.
  • Developer berafiliasi dengan domain yang dipratinjau.

Untuk mengetahui informasi selengkapnya, lihat Melihat pratinjau link dengan smart chip.

Add-on Drive

  • Jika aplikasi menyimpan file di Drive, pengguna dapat memilih folder atau membuat dan menggunakan kembali folder khusus aplikasi. Data konfigurasi dapat disimpan di folder App Data. Aplikasi tidak membuang file ke folder Drive Saya milik pengguna.
  • Add-on ini hanya menyimpan file di Drive yang terhubung ke fungsi add-on yang didokumentasikan.

Add-on Gmail

  • Add-on tidak menyebutkan atau menautkan ke ekstensi browser Chrome tanpa alasan yang jelas.
  • Menu Tindakan lainnya berisi tindakan universal yang berfungsi dengan baik. Misalnya, Logout, Tentang, Dukungan, dll.
Add-on Google Workspace Grafis

Add-on Kalender

  • Logo untuk solusi konferensi adalah URL publik. Lihat Memberikan logo solusi konferensi.
  • Jika add-on menggunakan calendar.conferenceSolution, logo solusi konferensi akan mengikuti persyaratan calendar.logoUrl. Lihat Resource manifes Kalender.
  • Jika add-on menggunakan calendar.logoUrl atau common.logoUrl, logo identik dengan ikon yang disediakan di listingan aplikasi.
  • Jika add-on menggunakan calendar.logoUrl atau common.logoUrl, URL logo akan dimulai sebagai berikut: https://lh3.googleusercontent.com/
Add-on Google Workspace OAuth

Add-on Drive

  • (Direkomendasikan) Jika Anda ingin menerima metadata terbatas, add-on akan menyertakan cakupan drive.addons.metadata.readonly.
Aplikasi web Fungsi
  • URL navigasi universal mengarah ke aplikasi web. Halaman web sederhana tanpa fungsionalitas tidak dianggap sebagai aplikasi web.