Proses peninjauan aplikasi dan persyaratan untuk Google Workspace Marketplace

• Tombol untuk berkomunikasi dengan aplikasi tersedia dari deskripsi.
• Nama aplikasi dimulai dengan A—Z (huruf besar) atau 0–9. Nama tidak boleh dimulai dengan simbol.

• Aplikasi mengirim pesan selamat datang tanpa perintah setiap kali pengguna memulai pesan langsung atau aplikasi ditambahkan ke ruang. Pesan selamat datang berbeda dengan perintah "Bantuan". Untuk informasi selengkapnya, lihat Membuat halaman beranda untuk aplikasi Google Chat.
• 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 di menu Chat.
• URL eksternal yang berinteraksi dengan aplikasi bukan milik 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 kesepakatan penjualan akan menambahkan informasi seperti akun, jumlah, dan tahap.
  • Developer berafiliasi dengan domain yang dilihat pratinjaunya.

  Untuk informasi selengkapnya, lihat Link pratinjau.

• (Direkomendasikan) Agar administrator Workspace dapat menginstal aplikasi Anda atas nama pengguna di organisasi mereka, aplikasi Anda harus dapat menerima dan mengirim pesan langsung.

• Aplikasi memiliki avatar yang jelas dan mudah dikenali.

• Aplikasi tidak menggunakan ekstensi browser Chrome untuk menyediakan fungsi dengan memanipulasi HTML Drive secara langsung.
• Jika menggunakan cakupan sensitif atau yang dibatasi, aplikasi Anda harus melalui verifikasi OAuth. Lihat Cara mengirimkan permohonan verifikasi.
• Jika menggunakan cakupan yang dibatasi, aplikasi Anda juga harus melalui penilaian keamanan. Lihat Mengapa penilaian keamanan diperlukan.

• Jika aplikasi menyimpan file di Drive, aplikasi tersebut memungkinkan pengguna memilih folder atau membuat dan menggunakan kembali folder khusus aplikasi. Data konfigurasi dapat disimpan di 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.

• Tindakan yang diharapkan dan diperlukan disertakan dalam add-on, dan add-on ini menyediakan semua alat yang diperlukan untuk menyelesaikan alur kerjanya. Contoh:
  • Jika add-on menerapkan gaya ke seluruh dokumen, add-on tersebut menawarkan opsi untuk menerapkan gaya hanya ke teks yang dipilih.
  • Jika add-on mengupload data spreadsheet ke feed layanan web, add-on tersebut memiliki link ke feed tersebut untuk memudahkan navigasi.
  • Jika add-on mewajibkan pengguna untuk memiliki akun, add-on tersebut 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 menggunakan onInstall() dan onOpen() dengan benar untuk mengisi menunya. Item menu akan diisi saat add-on pertama kali diinstal dan saat file lain dibuka. Lihat Otorisasi Add-on Editor.
• Mode otorisasi disiapkan dengan benar. Lihat Mode otorisasi.
• Add-on harus diterapkan di runtime V8 Apps Script. Untuk informasi selengkapnya, lihat ringkasan runtime V8.

• 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.
• Error dihindari jika memungkinkan dan dikelola dengan benar. Jika tidak:
  • Pesan error ditampilkan di jendela dialog, bukan di pemberitahuan JavaScript atau di panel merah default. Pesan tersebut menyampaikan masalah dan menjelaskan apa yang harus dilakukan pengguna untuk memperbaikinya dalam bahasa yang sederhana.
  • Jika memungkinkan, jika pengguna melakukan kesalahan, tombol akan ditampilkan untuk memperbaiki masalah tersebut.
  • Untuk informasi selengkapnya, lihat panduan gaya add-on.
• Link ke halaman eksternal terbuka di jendela baru dan sudah benar.
• Add-on bersifat intuitif dan didesain dengan baik. Artinya:
  • Selalu jelas apa yang harus dilakukan dan bagaimana melakukannya.
  • Add-on ini mudah diakses dan dipahami. Istilah teknis dan jargon dihindari.
  • Alur kerja dibuat jelas dan difasilitasi sebaik mungkin.
  • Pengguna dan kontennya aman semaksimal 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 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 300 p 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 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 Kalender

• Jika add-on menggunakan calendar.name atau common.name, nama dalam manifes akan identik dengan nama yang diberikan dalam listingan aplikasi.
• Jika add-on menggunakan calendar.conferenceSolution, nama solusi konferensi tidak akan berisi “Google Kalender”.
• (Direkomendasikan) Jika add-on menggunakan calendar.conferenceSolution, nama solusi konferensi tidak boleh melebihi 30 karakter.

• Add-on menggunakan widget yang benar (atau UI dengan iframe di Add-on Meet) untuk fungsi yang diinginkan. Misalnya, gunakan tombol akses untuk memilih nilai boolean.

Add-on Kalender

• Kalender sekunder dan delegasi didukung, atau jika tidak didukung, 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 baik.
• 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 diberikan di kolom catatan.
• Jika add-on menyediakan solusi konferensi, add-on tersebut 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 ditentukan.
• Jalur tidak kosong. Misalnya, https://altostrat/ tidak masalah, tetapi https://altostrat tidak valid.
• Karakter pengganti tidak dapat digunakan di UrlFetchApp.

Add-on Meet

• Login add-on dan perjalanan pengguna harus berfungsi meskipun cookie pihak ketiga dinonaktifkan.
• Add-on harus menyediakan fungsi yang relevan dengan pelaksanaan, atau partisipasi dalam, rapat.
• Add-on tidak boleh melakukan apa pun yang membuat pengguna keluar dari rapat, seperti memuat ulang browser.
• Jika Anda menggunakan pengalaman multi-pemain, add-on harus mengizinkan semua peserta untuk berkolaborasi dalam konten meskipun izin tidak ditetapkan sebelumnya. Penyesuaian izin harus tersedia selama sesi add-on kolaboratif.
• Add-on harus menangani pembatalan alur aktivitas mulai dan memungkinkan pengguna memulai ulang aktivitas dari aplikasi.
• Add-on harus menyediakan panel samping untuk login dan menyiapkan pengalaman aktivitas.
• Add-on tidak boleh menyediakan fungsi untuk mengundang bot atau mengandalkan kehadiran bot dalam rapat

• 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 (atau UI ber- iframe di Add-on Meet) berfungsi dengan baik. Misalnya, tidak ada item duplikat; tombol kembali, muat ulang, dan update berfungsi sebagaimana mestinya.
• Setelah pengguna memberikan otorisasi ke add-on, add-on akan menampilkan kartu halaman beranda yang disesuaikan (halaman web di Add-on Meet) 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 dengan jelas menunjukkan bahwa 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 scroll vertikal.
  • Lebar konten tidak melebihi 300 p 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 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 kesepakatan penjualan akan menambahkan informasi seperti akun, jumlah, dan tahap.
• Developer berafiliasi dengan domain yang dipratinjau.

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

Add-on Drive

• Jika aplikasi menyimpan file di Drive, aplikasi tersebut memungkinkan pengguna memilih folder atau membuat dan menggunakan kembali folder khusus aplikasi. Data konfigurasi dapat disimpan di 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 tidak menyebutkan atau menautkan ke ekstensi browser Chrome tanpa justifikasi.
• Menu Tindakan lainnya more_vert berisi tindakan universal yang berfungsi dengan baik. Misalnya, Logout, Tentang, Dukungan, dll.

Add-on Meet

• Jika add-on memerlukan lisensi atau langganan: Pesan yang mudah digunakan harus ditampilkan kepada pengguna jika pengguna tidak memiliki lisensi.
• Jika pengguna tidak dapat menggunakan add-on karena masalah pemberian lisensi, pesan error harus menyatakan dengan jelas alasan add-on tidak dapat digunakan dan menyarankan tindakan yang harus dilakukan pengguna untuk memperbaiki situasi tersebut.
• Listingan Google Workspace Marketplace untuk add-on harus menentukan detail tentang persyaratan lisensi dan langganan yang mungkin diperlukan untuk menggunakan add-on. Jika add-on memiliki tingkat berbayar, listingan Marketplace harus menyediakan link ke halaman web yang menawarkan informasi selengkapnya tentang harga atau cara menghubungi tenaga penjualan.
• Jika pengguna belum login, add-on harus menampilkan perintah login Sekali Ketuk yang ditemukan di Tampilkan Google Sekali Ketuk dan penggantian "Login dengan Google" yang ditemukan di Autentikasi. Selain mekanisme "Login dengan Google", opsi login lainnya mungkin ditawarkan.
• Add-on harus memiliki desain responsif yang dapat menyesuaikan konten dengan berbagai ukuran.
• Perjalanan pengguna add-on harus berfungsi meskipun cookie pihak ketiga dinonaktifkan.
• Add-on tidak boleh memiliki scroll horizontal dalam iframe.
• Jika ingin menggunakan panggung utama, add-on harus dirancang untuk pengalaman multipemain dan memungkinkan konten dimanipulasi oleh beberapa peserta secara bersamaan. Untuk pengalaman pemain tunggal, developer harus menggunakan panel samping.
• (Direkomendasikan) Add-on harus menampilkan identitas pengguna yang login.
• (Direkomendasikan) Pilihan pelokalan: bahasa harus didasarkan pada preferensi lokal yang ditetapkan oleh browser jika tersedia.
• (Direkomendasikan) Pemilihan konten harus melalui antarmuka penjelajahan konten yang menampilkan konten yang baru saja diakses.
• (Direkomendasikan) Jika panel samping tidak lagi diperlukan, add-on harus menutup panel samping setelah diluncurkan ke panggung utama.

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 Fasilitas 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 Meet

• Logo merek add-on harus memiliki ukuran dan gaya sehingga dapat diidentifikasi di panel samping Meet.
• URL logo mode gelap yang sesuai harus ditentukan dalam manifest add-on

Add-on Drive

• (Direkomendasikan) Jika Anda ingin menerima metadata terbatas, add-on akan menyertakan cakupan drive.addons.metadata.readonly.

• URL navigasi universal mengarah ke aplikasi web. Halaman web sederhana tanpa fungsi tidak dianggap sebagai aplikasi web.