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.

Cara pengguna menemukan dan menggunakan aplikasi Chat

Untuk menemukan aplikasi Google Chat, pengguna dapat melakukan salah satu hal berikut:

  • Telusuri dan instal aplikasi Chat dari Google Chat atau Google Workspace Marketplace.
  • 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:

Menambahkan aplikasi ke ruang dengan mengetik @ dalam pesan.

Cara administrator Google Workspace menginstal aplikasi Chat

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:

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

  1. 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
  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 . Dalam daftar API, klik Google Chat API.
  4. 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:
  • Menerima pesan 1:1: Pengguna dapat menemukan dan mengirim pesan ke aplikasi Chat langsung di Google Chat.
  • Bergabung ke ruang dan percakapan grup: Pengguna dapat menambahkan aplikasi Chat ke ruang dan percakapan grup.
Setelan koneksi Endpoint untuk aplikasi Chat, yang merupakan salah satu dari berikut ini:
  • URL Aplikasi: Endpoint HTTPS yang menghosting implementasi aplikasi Chat.
  • Project Apps Script: ID deployment untuk project Apps Script yang menerapkan aplikasi Chat.
  • Nama topik Cloud Pub/Sub: Topik Cloud Pub/Sub yang berlangganan aplikasi Chat sebagai endpoint.
  • Dialogflow: Mendaftarkan aplikasi Chat 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 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 melakukan salah satu hal berikut:

  • Publikasikan aplikasi Chat Anda secara publik dan izinkan pengguna Google Chat menambahkan aplikasi Anda ke ruang.
  • Publikasikan aplikasi Chat Anda ke organisasi Google Workspace.
  • 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:

  1. Uji aplikasi Chat Anda dengan menginstalnya dari Chat. Pastikan aplikasi Anda berfungsi sepenuhnya dan bukan pekerjaan yang sedang berlangsung.
  2. Tinjau persyaratan publikasi dan verifikasi bahwa aplikasi Anda memenuhi semua persyaratan tersebut. Lihat Area ulasan.
  3. 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.