Mengonfigurasi Google Chat API

Setiap aplikasi Google Chat yang Anda buat memerlukan project Google Cloud-nya sendiri dengan Chat API yang diaktifkan dan dikonfigurasi. Halaman ini menunjukkan cara mengonfigurasi Chat API.

Prasyarat

Memilih nama tampilan, avatar, dan deskripsi untuk aplikasi Chat

Saat mengaktifkan Chat API, Anda mengonfigurasi detail tentang aplikasi Chat yang muncul kepada pengguna di Chat, termasuk nama tampilan, avatar, dan deskripsi. Detail ini hanya muncul di Chat. Untuk memublikasikan aplikasi Chat ke Marketplace, Anda juga harus menentukan detail yang muncul di listingan Marketplace aplikasi Chat.

Untuk memanggil Chat API, Anda harus menyiapkan aplikasi Google Chat dengan informasi berikut:

Kolom Deskripsi Format
Nama aplikasi Nama tampilan untuk aplikasi Chat. Maksimal 25 karakter alfanumerik
URL avatar Gambar yang ditampilkan sebagai avatar aplikasi Chat Anda avatar. URL HTTPS yang mengarah ke gambar grafis persegi (PNG atau JPEG). Ukuran yang direkomendasikan adalah 256 x 256 piksel atau lebih.
Deskripsi Deskripsi singkat tentang tujuan aplikasi Chat. Maksimal 40 karakter alfanumerik

Nama, avatar, dan deskripsi aplikasi Chat ditampilkan kepada pengguna di UI Chat. Untuk beberapa permintaan tulis Chat API, Chat menggunakan informasi ini untuk mengaitkan tindakan yang dilakukan aplikasi Chat di Chat.

Misalnya, jika Anda memanggil metode spaces.create(), Chat akan menyertakan nama aplikasi Chat dalam deskripsi tentang siapa yang membuat ruang, seperti yang ditunjukkan pada gambar berikut:

Aplikasi Google Chat membuat ruang untuk pengguna.
Gambar 1. Pesan atribusi yang ditampilkan Chat saat metode spaces.create() digunakan untuk membuat ruang atas nama pengguna.

Untuk berinteraksi dengan aplikasi Chat, pengguna juga dapat melihat atau menggunakan informasi ini dengan cara berikut:

  • Memanggil aplikasi Chat dengan @menyebut namanya.
  • Menemukan dan memulai pesan langsung dengan aplikasi Chat. Di menu Aplikasi, pesan langsung menampilkan nama dan avatar aplikasi Chat.
  • Dari kolom tulis, pengguna dapat menjelajahi aplikasi Chat dan melihat nama, avatar, serta deskripsinya.

Mengonfigurasi aplikasi Chat di konsol Google Cloud

Setelah memiliki detail aplikasi Chat, buka project Cloud Anda dan konfigurasi Chat API:

  1. Di konsol Google Cloud, buka halaman Chat API dan klik halaman Konfigurasi:

    Buka halaman Konfigurasi Chat API

  2. Di bagian Info aplikasi, isi kolom Nama aplikasi, URL avatar, dan Deskripsi fields.

  3. Di bagian Fitur interaktif, klik tombol Aktifkan fitur interaktif ke posisi nonaktif untuk menonaktifkan fitur interaktif untuk aplikasi Chat. Anda dapat menyiapkannya nanti. Untuk mempelajari cara mengonfigurasi dan membuat fitur interaktif, lihat Menerima dan merespons interaksi pengguna.

  4. Opsional: Di bagian Log, centang kotak Log error ke Logging untuk menggunakan Google Cloud Logging. Untuk mengetahui informasi selengkapnya, lihat Membuat kueri log error untuk aplikasi Chat.

  5. Klik Simpan.

Memberikan izin kepada orang lain untuk mengonfigurasi Chat API

Anda dapat memberikan akses kepada pengguna tertentu ke halaman konfigurasi aplikasi Chat dengan memberikan peran Pemilik aplikasi Chat atau Pelihat aplikasi Chat Google Cloud Identity and Access Management (IAM). Pengguna dengan peran ini tidak dapat membuka halaman konfigurasi aplikasi Chat menggunakan dasbor API & Layanan, tetapi dapat mengakses halaman konfigurasi dengan membuka konsol Google Cloud untuk project Cloud host aplikasi Chat sebagai berikut:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Dengan PROJECT_ID sebagai project ID project Google Cloud yang menghosting aplikasi Chat.