Proses peninjauan aplikasi dan persyaratan Google Workspace Marketplace

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

Setelah Google meninjau aplikasi, Anda akan menerima email yang memberitahukan apakah aplikasi memerlukan lebih banyak upaya atau apakah aplikasi disetujui.

  • Jika aplikasi Anda memerlukan upaya tambahan—Anda akan menerima dokumen peninjauan yang berisi informasi spesifik tentang hal yang perlu ditingkatkan. Atasi masalahnya, lalu 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 Mempersiapkan proses publikasi.

Durasi peninjauan

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

  • Jumlah aplikasi yang baru-baru ini dikirim
  • 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, logo, atau deskripsi aplikasi. Untuk mendapatkan panduan, kunjungi pedoman branding Google Workspace Marketplace.
  • Link tidak berfungsi atau mengarah ke informasi yang salah. Misalnya, link untuk kebijakan privasi mengarah ke halaman dukungan developer.
  • Screenshot dan gambar berkualitas rendah, atau tidak merepresentasikan fungsi aplikasi secara akurat.

Kesiapan aplikasi:

  • Aplikasi masih diuji dan belum siap untuk publik.
  • 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 peninjauan awal.

Kategori Kriteria
Nama aplikasi
  • Tidak ada listingan aplikasi lain dengan nama yang sama.
  • Nama tidak menyertakan nomor versi.
  • Namanya sama dengan nama di layar izin OAuth.
  • Namanya tidak samar 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 merepresentasikan dan mengarahkan secara akurat ke informasi yang relevan tentang developer.
  • Berdasarkan hukum perlindungan konsumen, konsumen yang berbasis 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, keahlian, 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 pedagang tidak 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, deskripsi akan menjelaskan fungsi layanan pihak ketiga, cara aplikasi berinteraksi dengan layanan tersebut, dan secara opsional menautkan ke situs yang relevan.
  • Deskripsi singkat dan mendetail dapat dipahami.
  • Deskripsi singkat dan mendetail tidak identik.
  • (Direkomendasikan) Informasi harga lengkap dan akurat.
  • (Direkomendasikan) Kumpulan lengkap atribut per bahasa (nama, deskripsi singkat, dan deskripsi mendetail) didefinisikan 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 tidak dimaksudkan untuk tujuan iklan atau spamming.
  • Aplikasi berfungsi sepenuhnya dan tidak dimaksudkan untuk tujuan pengujian—aplikasi ini bukan dalam proses.
  • Jika aplikasi berinteraksi dengan fitur yang tersedia untuk pengguna atau pengguna berbayar, akun pengujian pada sistem developer akan 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 ini menggunakan SSO sekali klik atau idealnya SSO nol klik.
  • Setelah administrator memberikan izin cakupan OAuth 2.0 untuk domain, pengguna tidak akan dimintai izin cakupan lagi lagi.
  • Pengguna tidak perlu memasukkan kredensial setelah login ke Akun Google mereka. Biasanya, pengguna harus mengklik tombol "Login dengan Google" untuk mendapatkan akses.
  • Terdapat istilah yang konsisten, jelas, dan dapat dipahami untuk label tombol, item menu, judul, dan elemen aplikasi lainnya. Misalnya, sebagai ganti Ya atau Tidak, label merujuk pada nama tindakan seperti Hapus dan Batal.
  • Jika diperlukan login, fungsi logout 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 yang buram.
Grafik
  • Ikon berukuran tepat, persegi, dan memiliki latar belakang yang transparan. Lihat Aset visual.
  • Ikon merepresentasikan nama atau fungsi aplikasi dengan benar.
  • Ikon berwarna (bukan berwarna abu-abu).
  • Ikon tidak menggunakan merek dagang Google.
  • Screenshot dan gambar tidak buram, sulit dibaca, atau tidak pantas. Aplikasi ini mewakili aplikasi secara akurat.
  • (Direkomendasikan) Screenshot menunjukkan dengan jelas cara menggunakan aplikasi dan fungsinya.
OAuth
  • Aplikasi telah lulus verifikasi OAuth, menggunakan cakupan OAuth paling sempit, dan semua cakupan terintegrasi dengan benar dengan API Layanan Google.

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 peninjauan awal.

Integrasi aplikasi Kategori Kriteria
Aplikasi Google Chat Nama
  • Tombol untuk berkomunikasi dengan aplikasi tersedia dari deskripsi.
  • Nama aplikasi diawali dengan A—Z (huruf besar) atau 0–9. ID ini tidak boleh diawali dengan simbol.
Aplikasi Google Chat Pengalaman pengguna
  • Aplikasi mengirimkan pesan selamat datang yang tidak diminta setiap kali pengguna memulai pesan langsung atau aplikasi ditambahkan ke ruang. Pesan selamat datang berbeda dengan perintah "Help". Untuk mengetahui informasi selengkapnya tentang cara membuat pesan selamat datang yang baik, lihat Mem-build aplikasi Chat yang membantu dan menyenangkan pengguna.
  • Aplikasi mendukung perintah "Bantuan" dan membantu pengguna mulai menggunakan aplikasi. Untuk mengetahui informasi selengkapnya tentang cara membuat pesan bantuan yang baik, lihat Mem-build aplikasi Chat yang membantu dan menyenangkan pengguna.
  • Aplikasi selalu merespons saat berbicara di ruang atau Chat langsung.
  • Pesan menggunakan ejaan, kapitalisasi, tanda baca, dan tata bahasa yang benar. Pesan tidak berisi materi 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 mengirim 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 hal yang diperlukan untuk berinteraksi dengannya.
  • Format kartu yang digunakan aplikasi memenuhi persyaratan Google. Lihat Membuat kartu interaktif.
  • Aplikasi ini tersedia dari opsi Temukan aplikasi di menu Chat.
  • URL eksternal yang berinteraksi dengan aplikasi tidak termasuk dalam lingkungan staging atau pengembangan.
  • @sebutan wajib diisi di setiap pesan untuk aplikasi dalam ruang. Hanya cara itulah agar aplikasi mengetahui 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 transaksi penjualan akan menambahkan informasi seperti akun, jumlah, dan tahapan.
    • Developer berafiliasi dengan domain yang dipratinjau.

    Untuk informasi lebih lanjut, 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 Grafik
  • Aplikasi memiliki avatar yang dapat dikenali dan jelas.
Aplikasi Google Drive Fungsi
  • Aplikasi ini tidak menggunakan ekstensi browser Chrome untuk menyediakan fungsi dengan memanipulasi HTML Drive secara langsung.
  • Jika menggunakan cakupan sensitif atau yang dibatasi, aplikasi Anda harus menjalani verifikasi OAuth. Lihat Cara mengirimkan verifikasi.
  • Jika menggunakan cakupan yang dibatasi, aplikasi Anda juga harus menjalani penilaian keamanan. Lihat Alasan pentingnya penilaian keamanan.
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 dalam folder Data Aplikasi. Aplikasi tidak membuang file ke folder Drive Saya milik pengguna.
  • Aplikasi hanya menyimpan file dalam Drive yang terhubung ke fungsi aplikasi yang didokumentasikan.
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 penataan gaya ke seluruh dokumen, add-on akan menawarkan opsi untuk menerapkan penataan gaya hanya ke 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 add-on mewajibkan pengguna untuk memiliki akun, add-on akan memberikan link atau info untuk membuat akun dengan mudah jika pengguna belum memilikinya.
  • Add-on ini memiliki item menu di bawah tab add-on.
  • Meskipun hanya berfungsi sebagai kustom, add-on tetap menyertakan dokumentasi yang tepat.
  • Add-on menggunakan onInstall() dan onOpen() dengan benar untuk mengisi menunya. Item menu terisi saat add-on pertama kali diinstal dan saat file berbeda dibuka. Lihat Otorisasi Add-on Editor.
  • Mode otorisasi disiapkan dengan benar. Lihat Mode otorisasi.
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 penurunan performa add-on.
  • Error dapat dihindari jika memungkinkan dan dikelola dengan benar, jika tidak:
    • Pesan error ditampilkan di jendela dialog, bukan di pemberitahuan JavaScript atau di panel merah default. Notifikasi ini mengomunikasikan masalah dan menjelaskan apa yang harus dilakukan pengguna untuk memperbaikinya dengan bahasa yang sederhana.
    • Jika memungkinkan, jika pengguna melakukan kesalahan, 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 sudah 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. Istilah teknis dan jargon dihindari.
    • Alur kerjanya jelas dan difasilitasi sebanyak mungkin.
    • Pengguna dan kontennya seaman mungkin.
  • Add-on ini mengikuti panduan gaya UI untuk add-on editor dan menggunakan paket CSS untuk add-on editor.
  • Add-on hanya menggunakan satu tindakan utama berwarna biru per layar.
  • Add-on menampilkan dialog satu per satu. Tidak tumpang tindih atau memiliki beberapa dialog 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 memerlukan konfirmasi atau menampilkan peringatan untuk semua tindakan sensitif. Misalnya, jika add-on akan menimpa semua konten dalam spreadsheet, pengguna akan diberi peringatan dan mengonfirmasi tindakan tersebut sebelum terjadi.

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

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

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 melebihi 30 karakter.
Add-on Google Workspace Fungsi
  • Add-on menggunakan widget yang tepat untuk fungsi yang diinginkan. Misalnya, gunakan tombol akses untuk memilih nilai boolean.

Add-on Kalender

  • Delegasi dan kalender sekunder didukung, atau jika tidak didukung, akan dikelola dengan baik. Misalnya, pembuatan konferensi tidak akan gagal jika pengguna memilih kalender lain yang akses editnya mereka miliki saat membuat acara.
  • Acara rutin berfungsi dengan benar.
  • 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 lainnya yang didukung menggunakan kolom data terstruktur dan tidak disediakan di kolom catatan.
  • Jika add-on menyediakan solusi konferensi, add-on hanya akan mengedit detail konferensi dan tidak ada kolom acara lainnya.
  • Jika add-on menyediakan solusi konferensi, proses 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 valid.
  • 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 update berfungsi dengan semestinya.
  • Setelah pengguna memberikan otorisasi, add-on akan menampilkan kartu halaman beranda yang disesuaikan untuk menyambut pengguna dengan tombol login (jika diperlukan), logo, dan deskripsi singkat add-on.
    • Jika tombol login dipicu, tombol akan menampilkan halaman login yang disesuaikan dari vendor pihak ketiga yang dengan jelas menunjukkan ada layanan pihak ketiga yang berfungsi di luar Google Workspace.
  • UI add-on sangat cocok dalam ruang yang dialokasikan:
    • Teks dan label tidak terpotong dengan "..."
    • Pengguna tidak perlu melakukan banyak pengguliran 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 akan valid dan ditampilkan dengan benar di situs konferensi pihak ketiga.

Add-on Dokumen

Jika pratinjau add-on ditautkan dari domain pihak ketiga (chip pintar):

  • Pratinjau link menawarkan informasi tambahan yang relevan kepada pengguna. Misalnya, melihat pratinjau link ke transaksi penjualan akan menambahkan informasi seperti akun, 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 dalam folder Data Aplikasi. Aplikasi tidak membuang file ke folder Drive Saya milik pengguna.
  • Add-on hanya menyimpan file di Drive yang terhubung ke fungsionalitas add-on yang didokumentasikan.

Add-on Gmail

  • Add-on ini 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 Grafik

Add-on Kalender

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

Add-on Drive

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