Mengonfigurasi aplikasi Anda di Google Workspace Marketplace SDK

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

Agar aplikasi tersedia untuk digunakan, Anda perlu menyiapkannya di Google Workspace Marketplace SDK. Google Workspace Marketplace SDK adalah toolkit yang memungkinkan Anda membuat dan mengontrol 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 atau tidak (aplikasi pribadi), atau untuk semua pengguna Marketplace (aplikasi aplikasi publik)
• Jenis pengguna Marketplace yang dapat menginstal aplikasi
• Aplikasi Google Workspace yang terintegrasi dengan aplikasi Anda
• Cakupan OAuth yang diperlukan aplikasi Anda
• Informasi tentang siapa yang membuat dan mengelola aplikasi

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

Mengaktifkan Google Workspace Marketplace SDK

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

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

5. Buka halaman Google Workspace Marketplace SDK.

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

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

Menentukan setelan konfigurasi untuk aplikasi Anda

Referensi berikut menjelaskan setelan yang tersedia di Aplikasi Configuration Google Workspace 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 Google Workspace, baik listingan aplikasi Anda bersifat tidak publik, terlihat oleh semua pengguna di organisasi Anda, atau siapa saja yang menggunakan Gemini untuk Google Workspace.
• Setelan penginstalan: Apakah aplikasi hanya dapat diinstal oleh Administrator Google Workspace.

Terlepas dari setelan yang Anda tetapkan dalam listingan aplikasi, pengguna yang berada dalam organisasi Google Workspace mungkin tidak dapat menemukan, menginstal, atau menggunakan aplikasi berdasarkan pengaturan yang ditetapkan oleh administrator mereka. Administrator dapat memengaruhi ketersediaan aplikasi Anda dengan cara berikut:

• Mengontrol apakah pengguna mereka dapat melihat aplikasi di Marketplace, lalu menginstal aplikasi atas nama pelanggan.
• Menggunakan daftar yang diizinkan untuk mengelola dan menyeleksi aplikasi bagi organisasinya. 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 kasus 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

Peringatan: Setelah Anda memilih opsi visibilitas dan menyimpan Konfigurasi Aplikasi Anda tidak dapat mengubah pilihan di lain waktu.

Anda akan melihat opsi Visibilitas Aplikasi jika menggunakan Google Workspace (akun yang dibuat oleh organisasi kantor atau sekolah Anda). Jika Anda menggunakan akun konsumen (akun yang diakhiri dengan "@gmail.com"), Anda hanya dapat publikasikan untuk publik.

• Publik: Aplikasi dapat ditemukan dan diinstal oleh orang di luar {i>Directory<i} Jika Anda memilih visibilitas publik, Google akan meninjau dan menyetujui aplikasi Anda sebelum dipublikasikan.
• Pribadi: Hanya orang di dalam domain Anda yang dapat menemukan dan menginstal aplikasi Anda.

Jika Anda memilih untuk memublikasikannya sebagai Tidak publik, listingan aplikasi tidak akan muncul di penjelajahan atau hasil penelusuran. Pengguna hanya dapat mengakses halaman app store dengan .

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

Setelan penginstalan aplikasi

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 Individu + Admin Instal karena setiap orang dapat menemukan dan menginstal aplikasi Chat langsung dari Google Chat. Untuk detail tentang cara kerja penginstalan, lihat Memublikasikan aplikasi Google Chat.

• Penginstalan Perorangan + Admin (default): Aplikasi dapat diinstal dengan pengguna perorangan atau oleh admin untuk domain, unit organisasi, atau sekelompok pengguna tertentu. 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. 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 ditargetkan	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 pun di organisasi Anda.	Jika diizinkan, siapa pun di organisasi Anda.
Organisasi Anda	Pribadi	Khusus admin	Administrator	Pengguna yang telah 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 telah menginstal aplikasi oleh administrator mereka.
Semua pengguna Google Workspace	Public	Penginstalan Individu + Admin	Siapa saja yang menggunakan aplikasi Google Workspace untuk penggunaan pribadi. Jika diizinkan, pengguna di organisasi Google Workspace.	Siapa saja yang menggunakan aplikasi Google Workspace untuk penggunaan pribadi. Jika diizinkan, pengguna di organisasi Google Workspace.

Mengidentifikasi cara aplikasi Anda terintegrasi dengan aplikasi Google Workspace

Pilih layanan Google Workspace yang menjadi tujuan aplikasi atau add-on Anda yang diperlukan, seperti Add-on Google Workspace atau Aplikasi Google Chat. Anda harus memilih setidaknya satu opsi. Dalam beberapa kasus, Anda dapat menyertakan beberapa integrasi aplikasi di listingan aplikasi. Lihat Buat daftar integrasi aplikasi bersama-sama.

Bergantung pada integrasi aplikasi yang dipilih, Anda mungkin perlu menyediakan lebih banyak informasi penting dan mengaktifkan API yang relevan di project Google Cloud Anda. Hal berikut Tabel ini menjelaskan penyiapan tambahan yang diperlukan untuk setiap:

Add-on Google Workspace (Apps Script)

Untuk memublikasikan Add-on Google Workspace, Anda harus menyediakan ID deployment. Untuk menemukan ID deployment, ikuti langkah-langkah berikut:

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

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 Konfigurasi Aplikasi di bagian "Add-on Google Workspace", klik Terapkan menggunakan sumber daya deployment cloud > Pilih 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 Anda publikasikan.

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

1. Buka add-on di editor Apps Script.
2. Di sebelah kiri, klik Setelan project .
3. Di bagian "ID", menyalin 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 berukuran 96x96 dan 48x48 piksel.

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

1. Buka Add-on Google Workspace di Apps Script .
2. Klik Deploy > Deployment baru.
3. Di bagian "Pilih jenis", klik Web app.
4. Isi opsi yang tersedia, lalu klik Deploy.
5. Klik Salin.

Menentukan tingkat akses yang diperlukan aplikasi Anda

Di bagian Cakupan OAuth, berikan daftar lengkap cakupan OAuth aplikasi Anda Anda butuhkan. Cakupan OAuth yang Anda masukkan di sini harus sesuai dengan yang ditampilkan di Layar persetujuan OAuth dan, jika ada, manifes Apps Script.

Jika Anda menyertakan lebih dari satu integrasi aplikasi, pastikan Anda menambahkan cakupan dari satu per satu ke halaman Konfigurasi Aplikasi Google Workspace Marketplace SDK dan izin OAuth Anda layar.

Selalu gunakan cakupan paling sempit (misalnya, jangan sertakan cakupan Drive cakupan jika Anda hanya memerlukan cakupan hanya baca).

Untuk project Apps Script, lihat Cakupan untuk mengetahui detail selengkapnya.

Memberikan informasi tentang developer aplikasi

Di bagian Informasi developer, isi informasi kontak dan detail lainnya. Kolom ini muncul di bagian listingan Play Store Anda.

Kolom
Status pedagang	Berdasarkan hukum perlindungan konsumen, konsumen yang berbasis di Eropa Wilayah Ekonomi (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 untuk perdagangan, bisnis, keterampilan, atau profesi; atau atas nama atau pada nama seorang pedagang. Non-pedagang—Non-pedagang (konsumen) adalah orang yang bertindak untuk untuk tujuan non-profesional. Jika tidak ditentukan, "Status pedagang belum ditentukan" muncul di layar listingan Play Store kami.
Alamat surat developer	Wajib untuk pedagang. Tidak dikumpulkan untuk non-pedagang. Lokasi bisnis Anda. Masukkan alamat surat yang valid untuk dapat dihubungi.
Nama developer	Nama yang akan ditampilkan sebagai penulis aplikasi. Jika Anda seorang pedagang, memberikan nama dagang 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). Penting tidak disertakan dalam listingan aplikasi Anda. Pastikan alamat email ini selalu diperbarui {i>date<i}—ini digunakan: Jika Google perlu menghubungi developer—misalnya, selama proses peninjauan aplikasi. Untuk mengirim masukan dari add-on Editor jika URL Laporkan Masalah tidak yang diberikan di halaman Listingan Play Store.
URL situs aplikasi	Opsional. Situs yang menjelaskan aplikasi Anda lebih lanjut.

Menyimpan setelan konfigurasi aplikasi di Google Workspace Marketplace SDK

Dengan menggunakan informasi dari bagian sebelumnya, simpan konfigurasi aplikasi Anda di Google Workspace Marketplace SDK:

1. Buka Google Workspace Marketplace SDK.
2. Buka tab Konfigurasi Aplikasi.
3. Isi setiap bagian berdasarkan apa yang Anda tentukan di bagian sebelumnya.
4. Klik Simpan.
5. (Opsional) Anda bisa mendapatkan analisis tentang penggunaan aplikasi di Google Analytics. Untuk melakukannya, tambahkan ID Google Analytics di SDK Google Workspace Marketplace.
   1. Buka tab Analytics.
   2. Masukkan ID Google Analytics Anda.
   3. Klik Simpan.