Setelah membuat aplikasi Chat, Anda dapat memublikasikannya agar tersedia untuk orang atau grup tertentu, semua orang di organisasi Google Workspace Anda, atau pengguna Google Chat yang memiliki akun Google Workspace.
Cara pengguna menemukan dan menggunakan aplikasi Google Chat
Pengguna dapat menemukan dan mulai menggunakan aplikasi Chat dengan beberapa cara berbeda:
- Menelusuri aplikasi di Google Chat
- Berinteraksi dengan aplikasi yang telah ditambahkan ke ruang Chat
- Menemukan aplikasi di panel pesan langsung setelah administrator Google Workspace menginstal aplikasi atas nama mereka.
Untuk mulai menggunakan aplikasi, pengguna Google Chat dapat memulai pesan langsung dengan aplikasi atau menambahkannya ke ruang dengan memilihnya dari daftar penerima yang diusulkan seperti yang ditunjukkan di bawah ini:
Pengguna juga dapat mempersempit daftar penerima yang diusulkan dengan @menyebut aplikasi berdasarkan nama. Misalnya, jika Anda memublikasikan aplikasi bernama "Scheduler Bot" dan pengguna di organisasi Anda mengetik "@sch", Google Chat akan menyarankan aplikasi Anda sebagai salah satu opsi pelengkapan otomatis.
Atau, administrator Google Workspace dapat menemukan aplikasi Chat di Google Workspace Marketplace dan menginstal aplikasi untuk pengguna di organisasi mereka. Saat administrator menginstal aplikasi Chat, aplikasi tersebut akan muncul di panel pesan langsung pengguna.
Administrator Google Workspace juga dapat mengelola dan mengizinkan penggunaan aplikasi Chat di organisasi Google Workspace mereka. Jika Anda mengembangkan aplikasi Chat untuk organisasi yang menggunakan daftar yang diizinkan, Anda harus meminta administrator menambahkan aplikasi Chat ke daftar yang diizinkan agar pengguna dapat menemukan dan menggunakan aplikasi tersebut. Untuk informasi selengkapnya, lihat dokumentasi Bantuan Admin Google Workspace, Mengizinkan pengguna untuk menginstal aplikasi Chat.
Mengonfigurasi dan memublikasikan aplikasi Chat menggunakan Google Cloud Console
Untuk memublikasikan aplikasi Chat dan membuatnya tersedia untuk orang lain, biasanya Anda harus mengikuti langkah-langkah berikut:
- Mengaktifkan dan mengonfigurasi Google Chat API. Saat mengonfigurasi API, Anda memberi pengguna Google Chat akses ke aplikasi Chat untuk pengujian.
- Publikasikan aplikasi dengan Google Workspace Marketplace SDK. Anda dapat mengonfigurasi aplikasi Chat agar tersedia bagi pengguna di organisasi Google Workspace Anda, atau untuk semua pengguna Google Chat.
- Jika organisasi Google Workspace Anda mengelola akses ke aplikasi Chat, minta administrator Google Workspace untuk menambahkan aplikasi ke daftar yang diizinkan organisasi.
Setelan visibilitas dan publikasi untuk aplikasi Chat Anda
Tabel berikut menjelaskan cara mengonfigurasi setelan untuk Google Chat API dan Google Workspace Marketplace SDK berdasarkan audiens aplikasi Chat Anda:
. . . .| Saya sedang membuat aplikasi Chat... | Metode autentikasi | Setelan Google Chat API | Setelan Google Workspace Marketplace SDK | Di mana aplikasi Chat saya dipublikasikan? |
|---|---|---|---|---|
| ...Untuk tim kecil | Mengautentikasi sebagai pengguna atau aplikasi. | Di setelan Visibilitas, tentukan orang dan/atau Google Grup yang dapat mengakses aplikasi.
Jika akun Google Workspace Anda mengharuskan aplikasi untuk diizinkan, Anda hanya dapat menentukan hingga 5 alamat email individual (Anda tidak dapat menentukan Google Grup). |
Anda tidak perlu mengonfigurasi Google Workspace Marketplace SDK untuk aplikasi Chat. | Anggota tim dapat menemukan dan menggunakan aplikasi Chat Anda dari Google Chat. |
| ...Untuk tim besar saya | Mengautentikasi sebagai pengguna atau aplikasi. | Di setelan Visibilitas, tentukan orang dan/atau Google Grup untuk menguji aplikasi Chat Anda.
Setelah melakukan pengujian, publikasikan aplikasi Chat ke organisasi Google Workspace menggunakan setelan di Google Workspace Marketplace SDK. |
Setel Visibilitas aplikasi ke Pribadi. Setel Setelan penginstalan ke Perorangan + Admin. Jika akun Google Workspace Anda mewajibkan aplikasi untuk diberi akses, minta administrator menambahkan aplikasi Chat ke daftar yang diizinkan agar pengguna dapat menemukan dan menggunakan aplikasi. Untuk informasi selengkapnya, lihat dokumentasi Bantuan Admin Google Workspace, Izinkan pengguna menginstal aplikasi Chat. |
Siapa saja di organisasi Google Workspace Anda dapat menemukan dan menginstal aplikasi Chat di Google Chat, serta melihat aplikasi Anda di Google Workspace Marketplace. Pengguna dan administrator Google Workspace dapat menginstal aplikasi Anda dari Marketplace. |
| ...Untuk organisasi Google Workspace saya | Mengautentikasi sebagai pengguna atau aplikasi. | Di setelan Visibilitas, tentukan orang dan/atau Google Grup untuk menguji aplikasi Chat Anda.
Setelah melakukan pengujian, publikasikan aplikasi Chat ke organisasi Google Workspace menggunakan setelan di Google Workspace Marketplace SDK. |
Setel Visibilitas aplikasi ke Pribadi. Setel Setelan penginstalan ke Perorangan + Admin. |
Siapa saja di organisasi Google Workspace Anda dapat menemukan dan menginstal aplikasi Chat di Google Chat, serta melihat aplikasi Anda di Google Workspace Marketplace. Hanya administrator Google Workspace yang dapat menginstal aplikasi Anda dari Marketplace. |
| ...Untuk semua orang (aplikasi Chat publik) | Mengautentikasi sebagai aplikasi. | Di setelan Visibilitas, tentukan orang dan/atau Google Grup untuk
menguji aplikasi Chat Anda.
Setelah melakukan pengujian, publikasikan aplikasi Chat Anda secara publik menggunakan setelan di Google Workspace Marketplace. |
Setel Visibilitas aplikasi ke Publik. Setel Setelan penginstalan ke Perorangan + Admin |
Semua pengguna Google Workspace dapat menemukan dan menginstal aplikasi Chat Anda di Google Chat, serta melihat aplikasi Anda di Google Workspace Marketplace. Hanya administrator Google Workspace yang dapat menginstal aplikasi Anda dari Marketplace. |
Mengaktifkan dan mengonfigurasi Google Chat API
Siapkan project untuk aplikasi Anda di Google API Console dan aktifkan Google Chat API.
- Gunakan tombol di bawah ini untuk membuat project baru (atau pilih project yang sudah ada) dan tambahkan akun layanan ke project tersebut. Berikan peran Project Owner
ke akun layanan.
Mengaktifkan API - Simpan kunci JSON yang didownload. Aplikasi Anda dapat menggunakan kunci ini untuk mengautentikasi pesan yang dikirim ke ruang secara asinkron.
- Buka project Anda di API Console. Dalam daftar API, klik Google Chat API.
- Pilih tab Configuration dan masukkan informasi untuk aplikasi, seperti yang dijelaskan dalam tabel berikut.
Saat Anda menyimpan konfigurasi aplikasi, aplikasi akan tersedia bagi pengguna tertentu di organisasi Google Workspace Anda.
Setelan konfigurasi Google Chat API
| Kolom | Deskripsi |
|---|---|
| Nama aplikasi | Nama yang digunakan orang saat berinteraksi dengan aplikasi Anda. |
| URL avatar | URL HTTPS yang mengarah ke gambar grafis persegi (misalnya PNG atau JPEG), setidaknya 128x128, yang akan muncul sebagai avatar untuk aplikasi Anda. |
| Deskripsi | Deskripsi fungsi aplikasi yang muncul di bawah nama aplikasi Anda. |
| Fungsi | Sekumpulan kolom yang menentukan peristiwa yang dapat memicu aplikasi:
|
| Setelan koneksi | Endpoint untuk aplikasi, yang merupakan salah satu dari berikut ini:
|
| Perintah garis miring | Perintah yang dapat ditampilkan kepada pengguna dalam Google Chat. Memungkinkan pengguna melihat tindakan inti untuk aplikasi Anda dalam Google Chat, dan memilih tindakan tertentu yang ingin mereka ajak berinteraksi. |
| Penghapusan link | Pola URL yang dikenali aplikasi dan memberikan konten tambahan saat pengguna mengirim link. Untuk mengetahui informasi selengkapnya, lihat Link unfurl. |
| Visibilitas | Hingga 5 individu atau satu atau beberapa Google Grup yang dapat melihat dan menginstal aplikasi Chat Anda. Gunakan kolom ini untuk menguji aplikasi atau untuk berbagi aplikasi dengan tim Anda. Untuk mempelajari lebih lanjut, lihat Setelan visibilitas dan publikasi untuk aplikasi Chat. |
Memberikan izin konfigurasi aplikasi
Anda dapat memberikan akses ke halaman konfigurasi aplikasi kepada pengguna tertentu. Untuk melakukannya, gunakan peran IAM Pemilik aplikasi Chat dan aplikasi Chat . Pengguna dengan peran ini tidak dapat membuka halaman konfigurasi aplikasi melalui dasbor APIs & Services, tetapi dapat mengakses halaman konfigurasi dengan membuka konsol untuk project mereka seperti berikut:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=your-project-id
Memublikasikan aplikasi dengan Google Workspace Marketplace SDK
Gunakan Google Workspace Marketplace SDK untuk:
- Publikasikan aplikasi Anda secara publik dan izinkan pengguna Google Chat menambahkan aplikasi Chat ke ruang.
- Memublikasikan aplikasi ke domain Anda.
- Buat aplikasi Anda terlihat oleh administrator Google Workspace sehingga mereka dapat menginstal aplikasi tersebut untuk pengguna di organisasi mereka. Agar terlihat oleh administrator Google Workspace, aplikasi Anda harus menampilkan pesan langsung.
Sebelum memublikasikan aplikasi menggunakan Google Workspace Marketplace SDK, ikuti langkah-langkah berikut:
- Uji aplikasi Chat Anda dengan menginstalnya dari Chat. Pastikan aplikasi Anda berfungsi sepenuhnya dan tidak sedang dalam proses.
- Tinjau persyaratan publikasi dan pastikan aplikasi Anda memenuhi semuanya. Lihat Area peninjauan.
- Catat nomor versi aplikasi Anda. Anda memerlukan nomor ini untuk mengonfigurasi Google Workspace Marketplace SDK.
Jika sudah siap untuk memublikasikan, lihat Ringkasan: Memublikasikan aplikasi.
Menonaktifkan aplikasi Chat
Setelah Anda menyimpan halaman konfigurasi, kolom Status Aplikasi akan muncul. Kolom ini memungkinkan Anda mengontrol apakah aplikasi Aktif atau Dinonaktifkan.
Untuk menonaktifkan aplikasi Chat:
- Buka konsol Google Cloud.
- Jika perlu, pilih project Google Cloud yang menghosting
aplikasi Chat:
- Di samping "Google Cloud", klik Panah bawah . Dialog yang mencantumkan project saat ini akan muncul.
- Pilih project yang menghosting aplikasi Chat yang dimigrasikan.
- Klik Buka.
- Telusuri "Google Chat API", lalu klik Google Chat API.
- Klik Manage.
- Klik Konfigurasi.
- Di bagian "Status aplikasi", pilih Dinonaktifkan.
- Klik Simpan.