Mengonfigurasi aplikasi Anda di Google Workspace Marketplace SDK

Halaman ini menjelaskan cara menggunakan Google Workspace Marketplace SDK untuk mengonfigurasi dan mengelola aplikasi Anda di Google Workspace Marketplace.

Agar aplikasi Anda tersedia untuk digunakan, Anda perlu menyiapkannya di Google Workspace Marketplace SDK. Google Workspace Marketplace SDK adalah toolkit yang memungkinkan Anda membuat dan mengontrol aplikasi di Google Workspace Marketplace. Anda menggunakan Google Workspace 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 membuat dan memelihara aplikasi

Terlepas dari apakah Anda memublikasikan aplikasi secara publik atau pribadi, Anda harus menggunakan Google Workspace Marketplace SDK untuk mengelola aplikasi di Marketplace.

Mengaktifkan Google Workspace Marketplace SDK

Jika Anda belum melakukannya, di project Google Cloud, aktifkan Google Workspace Marketplace SDK:

1. Buka konsol Google Cloud.
2. Di bagian atas, klik Select a project. Jika project Google Cloud lain sudah terbuka, klik nama project Cloud untuk beralih project Cloud.
3. Pilih project Cloud aplikasi Anda, lalu klik Open.
4. Di bagian atas, di kotak penelusuran, ketik Google Workspace Marketplace SDK dan tekan enter.

5. Buka halaman Google Workspace Marketplace SDK.

   Peringatan: Pastikan Anda mengaktifkan Google Workspace Marketplace SDK, bukan API. Google Workspace Marketplace API adalah alat berbeda yang digunakan untuk berintegrasi dengan layanan pemberian lisensi dan penagihan Google.

6. Jika Google Workspace Marketplace SDK belum diaktifkan, klik Aktifkan.

Masukkan setelan aplikasi di Google Workspace Marketplace SDK

1. Buka Google Workspace Marketplace SDK.
2. Buka tab App Configuration.
3. Isi setiap bagian dengan informasi tentang aplikasi Anda. Untuk mempelajari setiap setelan, lihat bagian berikut Setelan konfigurasi aplikasi.
4. Klik Simpan.
5. (Opsional) Anda bisa mendapatkan analisis tentang penggunaan aplikasi di Google Analytics. Untuk melakukannya, tambahkan ID Google Analytics di Google Workspace Marketplace SDK.
   1. Buka tab Analytics.
   2. Masukkan ID Google Analytics Anda.
   3. Klik Simpan.

Setelan konfigurasi aplikasi

Referensi berikut menjelaskan setelan yang tersedia di halaman Konfigurasi Aplikasi di Google Workspace Marketplace SDK.

Visibilitas aplikasi

Peringatan: Setelah memilih opsi visibilitas dan menyimpan halaman Konfigurasi Aplikasi, Anda tidak dapat mengubah pilihan nanti.

Anda akan melihat opsi Visibilitas Aplikasi jika menggunakan akun Google Workspace (akun yang dibuat oleh organisasi kantor atau sekolah). Jika menggunakan akun konsumen (akun yang berakhiran "@gmail.com"), Anda hanya dapat memublikasikan aplikasi 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 aplikasi sebagai Tidak publik, listingan aplikasi tidak akan ditampilkan di hasil penjelajahan atau penelusuran. Pengguna hanya dapat mengakses halaman toko aplikasi dengan URL langsung.

Jika ingin membatasi negara dan wilayah tempat aplikasi Anda tersedia, siapkan di bagian Distribusi saat membuat listingan Play Store.

Setelan penginstalan

Setelan penginstalan menentukan apakah pengguna atau admin Workspace dapat menginstal aplikasi Anda dari halaman listingan Play Store di Google Workspace Marketplace.

Catatan: Untuk aplikasi Google Chat, Anda hanya dapat memilih Instal Admin + Perorangan karena setiap individu dapat menemukan dan menginstal aplikasi Chat langsung dari Google Chat. Untuk mengetahui detail tentang cara kerja penginstalan, lihat Memublikasikan aplikasi Google Chat.

• Penginstalan Individual + Admin (default): Aplikasi dapat diinstal oleh pengguna perorangan atau admin untuk domain, unit organisasi, atau grup pengguna. Kebijakan domain pengguna mungkin mencegah mereka menginstal aplikasi meskipun penginstalan individual diaktifkan.
• Instal Khusus Admin: Aplikasi hanya dapat diinstal oleh admin untuk domain, unit organisasi, atau grup pengguna mereka. Aplikasi Anda hanya akan muncul di hasil penelusuran Google Workspace Marketplace untuk admin dan orang yang belum login ke Akun Google mereka. Pilih opsi ini jika aplikasi Anda memerlukan penginstalan domain.

Integrasi aplikasi

Pilih layanan Google Workspace yang dirancang untuk berfungsi dengan 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 bersama-sama.

Bergantung pada integrasi aplikasi yang dipilih, Anda mungkin perlu memberikan informasi lebih lanjut dan mengaktifkan API yang relevan di project Google Cloud Anda. Tabel berikut menjelaskan penyiapan tambahan yang diperlukan untuk setiap penyiapan tersebut:

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:

1. Buka Add-on Google Workspace Anda di editor Apps Script.
2. Klik Deploy > Kelola deployment.
3. Pada ID deployment, klik Salin.

Add-on Google Workspace (Runtime alternatif)

Jika Anda membuat Add-on Google Workspace dalam bahasa coding selain Google Apps Script, ikuti langkah-langkah berikut untuk mendapatkan ID deployment dari resource deployment Google Cloud.

1. Di halaman App Configuration di bagian "Google Workspace Add-on", klik Deploy using cloud deployment resource > Select Deployment.
2. Pilih deployment yang ingin Anda publikasikan.
3. Klik Pilih.

Add-on Editor (Dokumen, Spreadsheet, Slide, Formulir)

Untuk memublikasikan Add-on Editor, Anda harus memberikan ID skrip project dan versi yang ingin dipublikasikan.

Untuk menemukan ID skrip project, ikuti langkah-langkah berikut:

1. Buka add-on di editor Apps Script.
2. Di sebelah kiri, klik Project settings .
3. Di bagian "ID", salin ID skrip.

Untuk menemukan versi, ikuti langkah-langkah berikut:

1. Buka add-on di editor Apps Script.
2. Di kanan atas, klik Deploy > Kelola deployment.
3. Nomor versi ada di bagian "Konfigurasi".

Aplikasi Google Chat

Untuk memublikasikan aplikasi Google Chat, Anda harus mengonfigurasi Google Chat API. Lihat Memublikasikan aplikasi.

Aplikasi Drive

Untuk memublikasikan aplikasi Drive, Anda harus mengaktifkan dan mengonfigurasi Drive API.

Aplikasi web

Untuk memublikasikan aplikasi web, Anda harus memberikan URL navigasi universal, yaitu URL yang mengarah ke aplikasi web dari menu aplikasi Google . Aplikasi web Anda harus berada dalam tahap produksi dan berfungsi sepenuhnya.

Saat mengisi halaman Listingan Play Store, Anda harus memberikan ikon tambahan yang berukuran 96x96 dan 48x48 piksel.

Jika Anda membuat aplikasi web di Apps Script, untuk mendapatkan URL navigasi universal, ikuti langkah-langkah berikut:

1. Buka Add-on Google Workspace Anda di editor Apps Script.
2. Klik Deploy > Deployment baru.
3. Di bagian "Pilih jenis", klik Aplikasi web.
4. Lengkapi opsinya, lalu klik Deploy.
5. Klik Salin.

Cakupan OAuth

Berikan daftar lengkap cakupan OAuth 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 menyertakan lebih dari satu integrasi aplikasi, pastikan Anda menambahkan cakupan dari masing-masing aplikasi ke halaman Konfigurasi Aplikasi Google Workspace 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 untuk detail selengkapnya.

Informasi pengembang

Kolom ini muncul di halaman listingan Play Store aplikasi Anda.

Kolom
Status pedagang	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.
Alamat surat developer	Wajib untuk trader. Tidak dikumpulkan untuk non-pedagang. Lokasi bisnis Anda. Masukkan alamat surat valid yang dapat dihubungi.
Nama developer	Nama yang akan ditampilkan sebagai pembuat aplikasi. Jika Anda adalah pedagang, berikan nama perdagangan atau nama resmi Anda.
URL situs developer	Situs yang mendeskripsikan Anda (atau organisasi Anda) sebagai developer.
Email developer	Alamat email yang akan digunakan sebagai kontak (POC). Data ini tidak disertakan dalam listingan aplikasi Anda. Pastikan alamat email ini selalu yang terbaru—yang digunakan: Jika Google perlu menghubungi developer—misalnya, selama proses peninjauan aplikasi. Untuk mengirim masukan dari add-on Editor jika URL Laporkan Masalah tidak disediakan di halaman Listingan Play Store.
URL situs aplikasi	Opsional. Situs yang mendeskripsikan aplikasi Anda lebih lanjut.