Memublikasikan aplikasi Google Chat

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:

Menambahkan aplikasi ke ruang dengan mengetik @ dalam pesan.

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:

  1. Mengaktifkan dan mengonfigurasi Google Chat API. Saat mengonfigurasi API, Anda memberi pengguna Google Chat akses ke aplikasi Chat untuk pengujian.
  2. 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.
  3. 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.

  1. 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
  2. Simpan kunci JSON yang didownload. Aplikasi Anda dapat menggunakan kunci ini untuk mengautentikasi pesan yang dikirim ke ruang secara asinkron.
  3. Buka project Anda di API Console. Dalam daftar API, klik Google Chat API.
  4. 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:
  • Menerima pesan 1:1: Pengguna dapat menemukan dan mengirim pesan langsung ke aplikasi di Google Chat.
  • Menerima peristiwa dari penginstalan admin: Terima peristiwa ADDED_TO_SPACE atau REMOVED_FROM_SPACE dari Chat saat admin Google Workspace menginstal atau meng-uninstal aplikasi di organisasi mereka. Secara default, aplikasi tidak menerima peristiwa ini kecuali Anda memilih untuk menerimanya karena dapat menghasilkan kueri per detik yang lebih tinggi.
  • Bergabung ke ruang dan percakapan grup: Aplikasi dapat bergabung ke ruang dan percakapan grup saat ditambahkan ke ruang dan percakapan grup tersebut.
Setelan koneksi Endpoint untuk aplikasi, yang merupakan salah satu dari berikut ini:
  • URL Aplikasi: Endpoint HTTPS tempat implementasi aplikasi dihosting.
  • Project Apps Script: ID deployment untuk project Apps Script yang mengimplementasikan aplikasi.
  • Nama topik Cloud Pub/Sub: Topik Cloud Pub/Sub yang menerima langganan aplikasi sebagai endpoint.
  • Dialogflow: Mendaftarkan aplikasi dengan integrasi Dialogflow. Untuk informasi selengkapnya, lihat dokumentasi Dialogflow tentang integrasi dengan Google Chat.
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:

  1. Uji aplikasi Chat Anda dengan menginstalnya dari Chat. Pastikan aplikasi Anda berfungsi sepenuhnya dan tidak sedang dalam proses.
  2. Tinjau persyaratan publikasi dan pastikan aplikasi Anda memenuhi semuanya. Lihat Area peninjauan.
  3. 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:

  1. Buka konsol Google Cloud.
  2. Jika perlu, pilih project Google Cloud yang menghosting aplikasi Chat:
    1. Di samping "Google Cloud", klik Panah bawah . Dialog yang mencantumkan project saat ini akan muncul.
    2. Pilih project yang menghosting aplikasi Chat yang dimigrasikan.
    3. Klik Buka.
  3. Telusuri "Google Chat API", lalu klik Google Chat API.
  4. Klik Manage.
  5. Klik Konfigurasi.
  6. Di bagian "Status aplikasi", pilih Dinonaktifkan.
  7. Klik Simpan.