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 kesesuaiannya dengan panduan desain, konten, dan gaya Google.

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

  • Jika aplikasi Anda memerlukan upaya tambahan—Anda akan menerima dokumen ulasan yang berisi informasi spesifik tentang hal yang perlu ditingkatkan. Atasi masalahnya, lalu kirim ulang aplikasi untuk ditinjau.
  • Jika tim peninjau menyetujui aplikasi Anda—Aplikasi akan otomatis dipublikasikan dan Anda 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 dikirimkan 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, logo, atau deskripsi aplikasi. Untuk mendapatkan panduan, buka 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 ini masih diuji dan belum siap untuk publik.
  • Aplikasi memiliki bug atau tidak berfungsi sepenuhnya.

Kriteria peninjauan

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 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 mewakili dan mengarahkan secara akurat ke informasi yang relevan tentang developer tersebut.
  • 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:
    • Trader—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 pedagang belum ditetapkan" 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 tersebut.
  • Jika aplikasi berinteraksi dengan layanan pihak ketiga, deskripsi akan menjelaskan tindakan yang dilakukan layanan pihak ketiga, cara aplikasi berinteraksi dengan layanan tersebut, dan jika perlu, 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 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 penuh. 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 iklan atau spamming.
  • Aplikasi berfungsi sepenuhnya dan tidak dimaksudkan untuk tujuan pengujian—aplikasi ini bukan pekerjaan yang sedang dalam proses.
  • Jika aplikasi berinteraksi dengan fitur yang tersedia untuk pengguna atau pengguna berbayar, akun pengujian di sistem developer akan disediakan untuk tim peninjau Google.
Pengalaman pengguna
  • Aplikasi, termasuk namanya, tidak menggunakan aset merek Google, 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 tanpa klik.
  • Setelah administrator memberikan izin bagi cakupan OAuth 2.0 untuk domain, masing-masing pengguna tidak akan dimintai izin cakupan lagi lagi.
  • Pengguna tidak perlu memasukkan kredensial setelah login ke Akun Google mereka. Untuk mendapatkan akses, pengguna harus mengklik tombol "Login dengan Google" untuk mendapatkan akses.
  • Terdapat istilah yang konsisten, jelas, dan mudah dipahami untuk label tombol, item menu, judul, dan elemen aplikasi lainnya. Misalnya, alih-alih Ya atau Tidak, label mengacu pada nama tindakan seperti Hapus dan Batal.
  • Jika login diperlukan, 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 yang kabur.
Grafis
  • Ikon berukuran tepat, persegi, dan memiliki latar belakang yang transparan. Lihat Aset visual.
  • Ikon merepresentasikan nama atau fungsi aplikasi dengan benar.
  • Ikon berwarna (bukan diskalakan untuk abu-abu).
  • Ikon tidak menggunakan merek dagang Google.
  • Screenshot dan gambar tidak buram, sulit dibaca, atau tidak pantas. Ikon tersebut 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 yang mungkin, 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 tinjauan 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. Nama tidak boleh diawali dengan simbol.
Aplikasi Google Chat Pengalaman pengguna
  • Aplikasi mengirim pesan selamat datang tanpa diminta setiap kali pengguna memulai pesan langsung atau aplikasi ditambahkan ke ruang. Pesan selamat datang berbeda dengan perintah "Help". Untuk mengetahui informasi selengkapnya, lihat Mengirim pesan kartu layar utama aplikasi.
  • Aplikasi mendukung perintah "Bantuan" dan membantu pengguna mulai menggunakan aplikasi. Untuk mengetahui informasi selengkapnya, lihat Merespons perintah garis miring.
  • Aplikasi selalu merespons saat diucapkan di ruang atau Chat langsung.
  • Pesan menggunakan ejaan, kapitalisasi, tanda baca, dan tata bahasa yang benar. Pesan tidak berisi materi berbahaya, menyinggung, atau kasar.
  • 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 mengirimkan 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 bukan milik lingkungan staging atau pengembangan.
  • Anda harus menggunakan @sebutan di setiap pesan untuk aplikasi di ruang. Itu satu-satunya cara agar aplikasi mengetahui bahwa aplikasi harus merespons.
  • Jika aplikasi Chat mempratinjau link dari domain pihak ketiga:
    • Pratinjau link menawarkan informasi tambahan yang relevan ke 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) Untuk mengizinkan administrator Workspace 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 dapat 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 tersebut harus menjalani verifikasi OAuth. Lihat Cara mengirimkan verifikasi.
  • Jika aplikasi Anda menggunakan cakupan yang dibatasi, aplikasi tersebut juga harus melalui penilaian keamanan. Lihat Alasan penilaian keamanan diperlukan.
Aplikasi Google Drive Pengalaman pengguna
  • Jika aplikasi menyimpan file di Drive, aplikasi memungkinkan pengguna 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 di 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 add-on menerapkan gaya 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 bawah tab add-on.
  • Meskipun hanya berfungsi sebagai fungsi kustom, add-on tetap menyertakan dokumentasi yang tepat.
  • Add-on menggunakan onInstall() dan onOpen() dengan benar untuk mengisi menunya. Item menu akan 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 dapat dikelola dengan benar, jika tidak:
    • Pesan error ditampilkan di jendela dialog, bukan di peringatan JavaScript atau di panel merah default. Contoh ini mengkomunikasikan masalah dan menjelaskan apa yang harus dilakukan pengguna untuk memperbaikinya dengan bahasa yang sederhana.
    • Jika memungkinkan, jika pengguna melakukan kesalahan, akan muncul tombol yang 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 dirancang dengan baik. Hal ini berarti:
    • Selalu jelas apa yang harus dilakukan dan bagaimana melakukannya.
    • Add-on ini dapat diakses dan mudah dipahami. Istilah teknis dan jargon dihindari.
    • Alur kerja berjalan dengan jelas dan difasilitasi sebanyak 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 hanya menggunakan satu tindakan utama berwarna biru per tampilan.
  • Add-on menampilkan dialog satu per satu. Dialog tidak tumpang tindih atau memiliki 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 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 menghilangkan 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 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 boleh melebihi 30 karakter.
Add-on Google Workspace Fungsi
  • Add-on 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, 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 akan 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 lain yang didukung menggunakan kolom data terstruktur dan tidak disediakan di kolom catatan.
  • Jika add-on menyediakan solusi konferensi, add-on hanya mengedit detail konferensi dan tidak ada kolom acara lainnya.
  • Jika add-on menyediakan solusi konferensi, pembuatan konferensi 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 ini 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 tombol login dipicu, tombol ini 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 penurunan performa add-on.

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 add-on mempratinjau link dari domain pihak ketiga (smart chip):

  • 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, aplikasi memungkinkan pengguna 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 fungsi add-on yang didokumentasikan.

Add-on Gmail

  • Add-on ini tidak menyebutkan atau menyediakan link ke ekstensi browser Chrome tanpa alasan.
  • 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 Menyediakan 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 dalam listingan aplikasi.
  • Jika add-on menggunakan calendar.logoUrl atau common.logoUrl, URL logo akan dimulai seperti 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 yang tidak memiliki fungsi tidak dianggap sebagai aplikasi web.