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.
Cara pengguna menemukan dan menggunakan aplikasi Google Chat
Untuk menemukan aplikasi Google Chat, pengguna dapat melakukan salah satu hal berikut:
- Telusuri dan instal aplikasi dari Google Chat.
- Berinteraksi dengan aplikasi yang telah ditambahkan ke ruang Chat.
- Temukan aplikasi di panel pesan langsung pengguna 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. Pengguna juga dapat menambahkan aplikasi dengan menyebutkannya menggunakan @. Contoh berikut menunjukkan cara pengguna @ menyebut aplikasi Chat untuk menambahkannya ke ruang:
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 akan muncul di panel pesan langsung pengguna.
Administrator Google Workspace juga dapat mengelola dan mengizinkan penggunaan aplikasi Chat di organisasi Google Workspace mereka. Jika mengembangkan aplikasi Chat untuk organisasi yang menggunakan daftar yang diizinkan, Anda harus meminta administrator menambahkan aplikasi Chat Anda ke daftar yang diizinkan agar pengguna dapat menemukan dan menggunakan aplikasi tersebut. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Bantuan Admin Google Workspace, Mengizinkan pengguna untuk menginstal aplikasi Chat.
Mengonfigurasi dan memublikasikan aplikasi Chat Anda menggunakan Konsol Google Cloud
Untuk memublikasikan aplikasi Chat Anda dan menyediakannya kepada orang lain, secara umum Anda harus mengikuti langkah-langkah berikut:
- Mengaktifkan dan mengonfigurasi Google Chat API. Saat mengonfigurasi API, Anda memberi pengguna Google Chat lain akses ke aplikasi Chat Anda untuk pengujian.
- Memublikasikan aplikasi dengan Google Workspace Marketplace SDK. Anda dapat mengonfigurasi aplikasi Chat agar tersedia bagi pengguna di organisasi Google Workspace Anda, atau bagi semua pengguna Google Chat.
- Jika organisasi Google Workspace Anda mengelola akses ke aplikasi Chat, minta administrator Google Workspace Anda 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:
| Pengguna aplikasi yang ditargetkan | Metode autentikasi | Setelan Google Chat API | Setelan Google Workspace Marketplace SDK | Di mana aplikasi Chat saya dipublikasikan? |
|---|---|---|---|---|
| Tim kecil Anda | Lakukan autentikasi sebagai pengguna atau aplikasi. | Di setelan Visibility, tentukan orang 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. |
| Tim besar Anda | Lakukan autentikasi sebagai pengguna atau aplikasi. | Di setelan Visibilitas, tentukan orang atau Google Grup untuk menguji aplikasi Chat Anda.
Setelah pengujian, publikasikan aplikasi Chat Anda ke organisasi Google Workspace menggunakan setelan di Google Workspace Marketplace SDK. |
Tetapkan Visibilitas aplikasi ke Pribadi. Tetapkan Setelan penginstalan ke Perorangan + Admin. Jika akun Google Workspace mewajibkan aplikasi untuk diizinkan, minta administrator untuk menambahkan aplikasi Chat Anda ke daftar yang diizinkan agar pengguna dapat menemukan dan menggunakan aplikasi tersebut. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Bantuan Admin Google Workspace, Mengizinkan pengguna untuk menginstal aplikasi Chat. |
Siapa pun di organisasi Google Workspace Anda dapat menemukan dan menginstal aplikasi Chat Anda di Google Chat, serta melihat aplikasi Anda di Google Workspace Marketplace. Pengguna dan administrator Google Workspace dapat menginstal aplikasi Anda dari Marketplace. |
| Organisasi Google Workspace Anda | Lakukan autentikasi sebagai pengguna atau aplikasi. | Di setelan Visibility, tentukan orang atau Google Grup untuk menguji aplikasi Chat Anda.
Setelah pengujian, publikasikan aplikasi Chat Anda ke organisasi Google Workspace menggunakan setelan di Google Workspace Marketplace SDK. |
Tetapkan Visibilitas aplikasi ke Pribadi. Tetapkan Setelan penginstalan ke Perorangan + Admin. |
Siapa pun di organisasi Google Workspace Anda 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. |
| Siapa saja (aplikasi Chat publik) | Lakukan autentikasi sebagai pengguna atau aplikasi. | Di setelan Visibility, tentukan orang atau Google Grup untuk menguji aplikasi Chat Anda.
Setelah pengujian, publikasikan aplikasi Chat Anda secara publik menggunakan setelan di Google Workspace Marketplace. |
Setel Visibilitas aplikasi ke Publik. Tetapkan Setelan penginstalan ke Perorangan + Admin |
Semua pengguna Google Workspace dapat menemukan dan menginstal aplikasi Chat Anda di Google Chat, dan 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 Cloud Console dan aktifkan Google Chat API:
- Gunakan tombol di bawah untuk membuat project baru (atau pilih project yang sudah ada) dan
menambahkan akun layanan ke project tersebut. Berikan peran Project Owner untuk akun layanan.
Aktifkan 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 . Dalam daftar API, klik Google Chat API.
- Pilih tab Configuration dan masukkan informasi untuk aplikasi, seperti yang dijelaskan pada tabel berikut.
Saat Anda menyimpan konfigurasi aplikasi, aplikasi akan tersedia untuk pengguna tertentu di organisasi Google Workspace Anda.
Setelan konfigurasi Google Chat API
| Kolom | Deskripsi |
|---|---|
| Nama aplikasi | Nama yang digunakan orang saat berinteraksi dengan aplikasi Chat Anda. |
| URL avatar | URL HTTPS yang mengarah ke gambar grafis persegi (misalnya PNG atau JPEG), berukuran minimal 128x128, yang akan muncul sebagai avatar untuk aplikasi Chat Anda. |
| Deskripsi | Deskripsi fungsi aplikasi Chat yang muncul di bawah nama aplikasi Chat Anda. |
| Fungsi | Kumpulan kolom yang menentukan cara aplikasi Chat berinteraksi dengan pengguna:
|
| Setelan koneksi | Endpoint untuk aplikasi Chat, 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 Chat Anda dalam Google Chat, dan memilih tindakan tertentu yang ingin mereka gunakan. |
| Pratinjau link | Pola URL yang dikenali aplikasi Chat dan memberikan konten tambahan saat pengguna mengirim link. Untuk informasi lebih lanjut, lihat Link pratinjau. |
| Visibilitas | Maksimum 5 orang atau satu atau beberapa Google Grup yang dapat melihat dan menginstal aplikasi Chat Anda. Gunakan kolom ini untuk menguji aplikasi Chat Anda, atau untuk membagikan aplikasi Chat kepada 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 Viewer 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 dengan cara berikut:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=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 untuk menambahkan aplikasi Chat Anda ke ruang.
- Publikasikan aplikasi ke domain Anda.
- Buat aplikasi Anda terlihat oleh administrator Google Workspace sehingga mereka dapat menginstal aplikasi untuk pengguna di organisasi mereka. Agar dapat dilihat oleh administrator Google Workspace, aplikasi Anda harus memiliki fitur 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 bukan pekerjaan yang sedang berlangsung.
- Tinjau persyaratan publikasi dan verifikasi bahwa aplikasi Anda memenuhi semua persyaratan tersebut. Lihat Area ulasan.
- Catat nomor versi aplikasi Anda. Anda memerlukan nomor ini untuk mengonfigurasi Google Workspace Marketplace SDK.
Jika sudah siap untuk memublikasikan aplikasi, lihat Ringkasan: Memublikasikan aplikasi.
Menonaktifkan aplikasi Chat Anda
Setelah Anda menyimpan halaman konfigurasi, kolom Status Aplikasi akan muncul. Kolom ini memungkinkan Anda mengontrol apakah aplikasi Live atau Disabled.
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.
- Cari "Google Chat API", lalu klik Google Chat API.
- Klik Manage.
- Klik Configuration.
- Di bagian "Status aplikasi", pilih Dinonaktifkan.
- Klik Simpan.