Mengonfigurasi Google Chat API

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

Prasyarat

Memilih nama tampilan, avatar, dan deskripsi untuk aplikasi Chat Anda

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

Kolom Deskripsi Format
Nama aplikasi Nama tampilan untuk aplikasi Chat. Hingga 25 karakter alfanumerik
URL avatar Gambar yang ditampilkan sebagai gambar 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 bahwa tujuan dari Aplikasi Chat. Hingga 40 karakter alfanumerik

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

Misalnya, jika Anda memanggil metode spaces.create(), Chat menyertakan nama aplikasi Chat di deskripsi pembuat ruang, seperti yang ditunjukkan dalam gambar berikut:

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

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

  • Panggil aplikasi Chat dengan @menyebut namanya.
  • Temukan dan mulai pesan langsung dengan aplikasi Chat. Di menu Aplikasi, pesan langsung akan menampilkan Nama dan avatar aplikasi Chat.
  • Dari kolom tulis, pengguna dapat menjelajahi aplikasi Chat dan melihat nama, avatar, dan deskripsi mereka.

Mengonfigurasi aplikasi Chat Anda di Konsol Google Cloud

Setelah Anda memiliki detail aplikasi Chat, buka Project cloud 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 Application info, isi App name, Avatar URL, dan Deskripsi.

  3. Di bagian Interactive Features, klik tombol Enableinteractive features ke posisi nonaktif untuk menonaktifkan fitur interaktif bagi Aplikasi Chat. Anda dapat menyiapkannya nanti. Untuk mempelajari tentang mengkonfigurasi dan membangun fitur interaktif, melihat Menerima dan merespons interaksi pengguna.

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

  5. Klik Simpan.

Memberikan izin kepada orang lain untuk mengonfigurasi aplikasi Chat

Anda dapat memberi akses kepada pengguna tertentu ke halaman konfigurasi aplikasi Chat. Gunakan IAM Pemilik aplikasi Chat dan Viewer aplikasi Chat peran. Pengguna dengan peran ini tidak dapat membuka aplikasi Chat halaman konfigurasi menggunakan API API & Layanan Google, 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 adalah project ID Project Google Cloud yang menghosting aplikasi Chat.