Halaman ini menjelaskan cara menggunakan Google Workspace Marketplace SDK untuk mengonfigurasi dan mengelola aplikasi Anda di Google Workspace Marketplace.
Agar aplikasi tersedia untuk digunakan, Anda harus menyiapkannya di Marketplace SDK. Marketplace SDK adalah toolkit yang memungkinkan Anda membuat dan mengontrol aplikasi di Google Workspace Marketplace. Anda menggunakan Marketplace SDK untuk mengelola setelan Marketplace, seperti berikut:
- Apakah aplikasi Anda tersedia untuk organisasi Google Workspace tertentu (aplikasi pribadi), atau untuk semua pengguna Marketplace (aplikasi publik)
- Jenis pengguna Marketplace yang dapat menginstal aplikasi Anda
- Aplikasi Google Workspace yang terintegrasi dengan aplikasi Anda
- Cakupan OAuth yang diperlukan aplikasi Anda
- Informasi tentang siapa yang mem-build dan mengelola aplikasi
Terlepas dari apakah Anda memublikasikan aplikasi secara pribadi atau publik, Anda harus menggunakan Marketplace SDK untuk mengelola aplikasi di Marketplace.
Mengaktifkan SDK Marketplace
Jika Anda belum melakukannya, aktifkan Google Workspace Marketplace SDK di project Google Cloud Anda.
Buka project Cloud Anda di konsol Google Cloud
Jika belum terbuka, buka project Cloud yang ingin Anda gunakan untuk contoh ini:
- Di konsol Google Cloud, buka halaman Select a project.
- Pilih project Google Cloud yang ingin Anda gunakan. Atau, klik Buat project dan ikuti petunjuk di layar. Jika membuat project Google Cloud, Anda mungkin perlu mengaktifkan penagihan untuk project tersebut.
Mengaktifkan Google Workspace Marketplace SDK
Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.Di konsol Google Cloud, aktifkan Google Workspace Marketplace SDK.
Menentukan setelan konfigurasi untuk aplikasi Anda
Referensi berikut menjelaskan setelan yang tersedia di halaman App Configuration di Marketplace SDK.
Memilih siapa yang dapat melihat dan menginstal aplikasi Anda
Saat mengonfigurasi aplikasi, Anda menentukan pengguna yang dapat mengakses aplikasi menggunakan setelan berikut:
- Visibilitas aplikasi: Jika Anda memublikasikan aplikasi dalam organisasi Google Workspace, baik listingan aplikasi Anda tidak dicantumkan, terlihat oleh semua pengguna di organisasi Anda, atau siapa saja yang menggunakan Google Workspace.
- Setelan penginstalan: Apakah aplikasi hanya dapat diinstal oleh administrator Google Workspace.
Terlepas dari setelan yang Anda tentukan dalam listingan aplikasi, pengguna yang tergabung dalam organisasi Google Workspace mungkin tidak dapat menemukan, menginstal, atau menggunakan aplikasi Anda berdasarkan setelan yang ditetapkan oleh administrator mereka. Administrator dapat memengaruhi ketersediaan aplikasi Anda dengan cara berikut:
- Mengontrol apakah pengguna mereka dapat melihat aplikasi di Marketplace, dan menginstal aplikasi atas nama pengguna mereka.
- Menggunakan daftar yang diizinkan untuk mengelola dan menyeleksi aplikasi bagi organisasi mereka. Jika Anda mengembangkan aplikasi untuk organisasi yang menggunakan daftar yang diizinkan, hubungi administrator untuk menambahkan aplikasi ke daftar yang diizinkan.
- Menonaktifkan aplikasi Google Workspace tertentu, seperti menghapus akses ke Google Chat, aplikasi Google Chat, atau keduanya. Dalam hal ini, pengguna tidak akan dapat menginstal aplikasi Anda dari Marketplace.
Untuk mempelajari cara administrator mengelola akses ke Marketplace, lihat dokumentasi Bantuan Admin Marketplace.
Setelan visibilitas aplikasi
Anda akan melihat opsi Visibilitas Aplikasi jika menggunakan akun Google Workspace (akun yang dibuat oleh organisasi kerja atau sekolah Anda). Jika menggunakan akun konsumen (akun yang berakhiran "@gmail.com"), Anda hanya dapat memublikasikan secara publik.
- Publik: Aplikasi dapat ditemukan dan diinstal oleh orang di luar domain Anda. Jika Anda memilih visibilitas publik, Google akan meninjau dan menyetujui listingan aplikasi Anda sebelum dipublikasikan.
- Pribadi: Hanya orang dalam domain Anda yang dapat menemukan dan menginstal aplikasi Anda.
Jika Anda memilih untuk memublikasikan sebagai Tidak Tercantum, listingan aplikasi tidak akan ditampilkan di hasil penelusuran atau penjelajahan. Pengguna hanya dapat mengakses halaman Play Store aplikasi dengan URL langsung.
Jika ingin membatasi negara dan wilayah tempat aplikasi tersedia, Anda harus menyiapkannya di bagian Distribusi saat membuat listingan Play Store.
Setelan penginstalan aplikasi
Opsi Setelan Penginstalan menentukan apakah pengguna atau admin Google Workspace dapat menginstal aplikasi Anda dari halaman listingan toko di Google Workspace Marketplace.
- Penginstalan Individu + Admin (default): Aplikasi dapat diinstal oleh pengguna perorangan atau oleh admin untuk domain, unit organisasi, atau grup pengguna mereka. Kebijakan domain pengguna dapat mencegahnya menginstal aplikasi meskipun penginstalan individual diaktifkan.
- Penginstalan Khusus Admin: Aplikasi hanya dapat diinstal oleh admin untuk domain, unit organisasi, atau grup pengguna mereka. Aplikasi Anda hanya muncul di hasil penelusuran Google Workspace Marketplace untuk admin dan orang yang tidak login ke Akun Google mereka. Pilih opsi ini jika aplikasi Anda memerlukan penginstalan domain.
Setelan penginstalan dan visibilitas umum
Tabel berikut merangkum beberapa opsi konfigurasi aplikasi umum untuk penginstalan dan visibilitas:
| Pengguna aplikasi yang diinginkan | Setelan Visibilitas aplikasi | Setelan Penginstalan aplikasi | Siapa yang dapat menginstal aplikasi saya? | Siapa yang dapat menggunakan aplikasi saya? | |
|---|---|---|---|---|---|
| Untuk aplikasi yang dibuat untuk organisasi Google Workspace | |||||
| Pengguna tertentu di organisasi Anda | Pribadi dan Tidak Publik | Penginstalan Individu + Admin | Jika diizinkan, siapa pun di organisasi Anda yang memiliki URL listingan aplikasi. | Jika diizinkan, siapa pun di organisasi Anda yang memiliki URL listingan aplikasi. | |
| Organisasi Anda | Pribadi | Penginstalan Individu + Admin | Jika diizinkan, siapa saja di organisasi Anda. | Jika diizinkan, siapa saja di organisasi Anda. | |
| Organisasi Anda | Pribadi | Khusus admin | Administrator | Pengguna yang menginstal aplikasi oleh administrator mereka. | |
| Untuk aplikasi yang tersedia bagi pengguna di luar organisasi Google Workspace tertentu | |||||
| Pengguna di organisasi Google Workspace | Public | Khusus admin | Administrator | Pengguna yang menginstal aplikasi oleh administrator mereka. | |
| Semua pengguna Google Workspace | Public | Penginstalan Individu + Admin |
|
|
|
Mengidentifikasi cara aplikasi Anda terintegrasi dengan aplikasi Google Workspace
Pilih layanan Google Workspace yang akan berfungsi dengan desain aplikasi atau add-on Anda, seperti add-on Google Workspace atau aplikasi Google Chat. Anda harus memilih setidaknya satu opsi. Dalam beberapa kasus, Anda dapat menyertakan beberapa integrasi aplikasi dalam listingan aplikasi. Lihat Mencantumkan integrasi aplikasi dalam satu listingan.
Bergantung pada integrasi aplikasi yang Anda pilih, Anda mungkin perlu memberikan informasi lebih lanjut dan mengaktifkan API yang relevan di project Google Cloud. Tabel berikut menjelaskan penyiapan tambahan yang diperlukan untuk setiap:
Add-on Google Workspace (Apps Script)
Untuk memublikasikan add-on Google Workspace, Anda harus memberikan ID deployment add-on. Untuk menemukan ID deployment, ikuti langkah-langkah berikut:
- Buka add-on Google Workspace Anda di editor Apps Script.
- Klik Deploy > Manage deployments.
- Di bagian ID deployment, klik Salin.
Add-on Google Workspace (deployment HTTP)
Jika Anda mem-build add-on Google Workspace menggunakan endpoint HTTP, ikuti langkah-langkah berikut untuk mendapatkan ID deployment dari resource deployment Google Cloud.
- Di halaman Konfigurasi Aplikasi pada bagian "Add-on Google Workspace", klik HTTP atau deployment lainnya > Pilih Deployment.
- Pilih deployment yang ingin dipublikasikan.
- Klik Pilih.
Add-on editor (Dokumen, Spreadsheet, Slide, Formulir)
Untuk memublikasikan add-on Editor, Anda harus memberikan project ID dan versi skrip yang ingin dipublikasikan.
Untuk menemukan ID skrip project, ikuti langkah-langkah berikut:
- Buka add-on di editor Apps Script.
- Di sebelah kiri, klik Project settings .
- Di bagian "ID", salin ID skrip.
Untuk menemukan versi, ikuti langkah-langkah berikut:
- Buka add-on di editor Apps Script.
- Di kanan atas, klik Deploy > Manage deployments.
- Nomor versi ada di bagian "Konfigurasi".
Aplikasi Google Chat
Untuk memublikasikan aplikasi Google Chat, Anda harus mengonfigurasi Google Chat API. Lihat Memublikasikan aplikasi Google Chat.
Aplikasi Drive
Untuk memublikasikan aplikasi Drive, Anda harus mengaktifkan dan mengonfigurasi Google Drive API.
Aplikasi web
Untuk memublikasikan aplikasi web, Anda harus memberikan URL navigasi universal-nya, yaitu URL yang mengarah ke aplikasi web dari menu aplikasi Google . Aplikasi web Anda harus dalam produksi dan berfungsi sepenuhnya.
Saat mengisi halaman Listingan Play Store, Anda harus memberikan ikon tambahan berukuran 96x96 dan 48x48 piksel.
Jika Anda mem-build aplikasi web di Apps Script, ikuti langkah-langkah berikut untuk mendapatkan URL navigasi universal:
- Buka add-on Google Workspace Anda di editor Apps Script.
- Klik Deploy > New deployment.
- Di bagian "Pilih jenis", klik Aplikasi web.
- Isi opsi, lalu klik Deploy.
- Klik Salin.
Menentukan tingkat akses yang diperlukan aplikasi Anda
Di bagian OAuth Scopes, berikan daftar lengkap cakupan OAuth 2.0 yang diperlukan aplikasi Anda. Cakupan OAuth yang Anda masukkan di sini harus cocok dengan yang Anda tampilkan di layar izin OAuth dan jika berlaku, manifes Apps Script.
Jika Anda menyertakan lebih dari satu integrasi aplikasi, pastikan Anda menambahkan cakupan dari setiap integrasi ke halaman Konfigurasi Aplikasi Marketplace SDK dan layar izin OAuth Anda.
Selalu gunakan cakupan sempit yang memungkinkan (misalnya, jangan sertakan cakupan Drive penuh jika Anda hanya memerlukan cakupan hanya baca).
Untuk project Apps Script, lihat Cakupan otorisasi untuk mengetahui detail selengkapnya.
Memberikan informasi tentang developer aplikasi
Di bagian Informasi Developer, isi informasi kontak dan detail lainnya. Kolom ini muncul di halaman listingan toko aplikasi Anda.
| Kolom | |
|---|---|
| Status pedagang |
Sesuai dengan hukum perlindungan konsumen, konsumen yang berada di Wilayah Ekonomi Eropa (EEA) harus diberi tahu apakah penjual di Marketplace Google Workspace adalah pedagang atau non-pedagang:
Jika tidak ditentukan, "Status trader tidak ditentukan" akan muncul di halaman listingan Play Store aplikasi Anda. |
| Nama developer | Nama yang akan ditampilkan sebagai penulis aplikasi. Jika Anda adalah pedagang, berikan nama dagang atau nama resmi Anda. |
| Alamat surat developer |
Wajib untuk trader. Tidak dikumpulkan untuk non-pedagang. Lokasi bisnis Anda. Masukkan alamat surat yang valid yang dapat digunakan untuk menghubungi Anda. |
| URL situs developer | Situs yang mendeskripsikan Anda (atau organisasi Anda) sebagai developer. |
| Email developer |
Alamat email yang akan digunakan sebagai kontak. Tidak disertakan dalam listingan aplikasi Anda. Pastikan alamat email ini selalu diperbarui saat digunakan:
|
| URL situs aplikasi | Opsional. Situs yang menjelaskan aplikasi Anda lebih lanjut. |
Menyimpan setelan konfigurasi aplikasi di Marketplace SDK
Dengan menggunakan informasi dari bagian sebelumnya, simpan konfigurasi aplikasi Anda di Marketplace SDK:
Di konsol Google Cloud, buka halaman Konfigurasi Marketplace SDK:
Isi setiap bagian berdasarkan hal yang Anda tentukan di bagian sebelumnya.
Klik Simpan.
(Opsional) Anda dapat mendapatkan analisis tentang penggunaan aplikasi di Google Analytics. Untuk melakukannya, tambahkan ID Google Analytics di Marketplace SDK.
- Buka tab Analytics.
- Masukkan ID Google Analytics Anda.
- Klik Simpan.