Bagian ini menjelaskan cara aplikasi Google Chat dapat memanggil Chat API, yang memungkinkan aplikasi Chat melakukan hal-hal seperti membuat ruang, menambahkan orang ke ruang, dan memposting pesan.
Autentikasi
Memanggil Chat API memerlukan autentikasi. Setiap metode Chat API memerlukan autentikasi pengguna (untuk melakukan tindakan atau mengakses data atas nama pengguna) atau autentikasi aplikasi (untuk melakukan tindakan atau mengakses data sebagai aplikasi Chat). Beberapa metode mendukung autentikasi pengguna dan autentikasi aplikasi.
Untuk mempelajari autentikasi di Chat lebih lanjut, lihat Ringkasan autentikasi.
Library klien
Cara yang direkomendasikan bagi sebagian besar developer untuk memanggil Google Chat API adalah dengan menggunakan Library Klien Cloud kami yang didukung secara resmi untuk bahasa pilihan Anda, seperti Python, Java, atau Node.js.
Jika Anda melakukan coding dengan Google Apps Script, gunakan layanan Chat Lanjutan, bukan menginstal library klien.
Konsep Google Chat API
Layanan gRPC atau resource dan metode REST memberikan akses ke ruang Chat, anggota ruang, pesan, reaksi pesan, lampiran pesan, peristiwa ruang, dan status baca pengguna.
- Ruang
Ruang adalah tempat orang dan aplikasi dapat berkomunikasi serta berbagi file. Ada beberapa jenis ruang. Pesan langsung (DM) adalah percakapan 1:1 antara dua pengguna atau pengguna dan aplikasi Chat. Chat grup adalah percakapan antara tiga pengguna atau lebih dan aplikasi Chat. Ruang bernama adalah tempat persisten tempat orang mengirim pesan, berbagi file, dan berkolaborasi.
Referensi resource:
Untuk contoh penggunaan, lihat:
- Anggota
Anggota adalah pengguna dan aplikasi Chat yang telah bergabung atau diundang ke ruang.
Referensi resource:
Untuk contoh penggunaan, lihat:
- Pesan
Pesan mencakup komunikasi teks dan kartu yang diposting di ruang. Pesan dapat berisi lampiran file. Orang dapat bereaksi terhadap pesan dengan menambahkan emoji.
Referensi resource:
Untuk contoh penggunaan, lihat:
- Reaksi
Reaksi mewakili emoji yang digunakan orang untuk bereaksi terhadap pesan, seperti 👍, 🚲, dan 🌞.
Referensi resource:
Untuk contoh penggunaan, lihat:
- Emoji kustom (Pratinjau Developer)
Emoji kustom mewakili emoji kustom yang dibuat dan dibagikan dalam organisasi di Google Chat. Emoji kustom dapat disertakan dalam konten pesan atau digunakan untuk bereaksi terhadap pesan.
Referensi resource:
- Media dan lampiran
Media mewakili file yang diupload ke Google Chat, seperti gambar, video, dan dokumen.
Referensi resource media (Tidak tersedia di RPC):
Lampiran adalah instance media (file) yang dilampirkan ke pesan.
Referensi resource:
Untuk contoh penggunaan, lihat:
- Peristiwa ruang
Peristiwa ruang mewakili perubahan pada ruang atau resource turunannya, termasuk anggota, pesan, dan reaksinya.
Referensi resource:
Untuk contoh penggunaan, lihat:
- Status baca pengguna
Status baca pengguna adalah resource singleton yang mewakili detail tentang pesan terakhir yang dibaca pengguna tertentu di ruang Google Chat atau rangkaian pesan pesan.
Referensi resource status baca ruang:
Referensi resource status pembacaan thread:
Untuk contoh penggunaan, lihat:
- Setelan notifikasi ruang pengguna (Pratinjau Developer)
Setelan notifikasi ruang pengguna adalah resource singleton yang mewakili setelan notifikasi pengguna yang ditentukan di ruang Google Chat.
Referensi resource:
Topik terkait
- Jelajahi contoh aplikasi Google Chat untuk mulai menggunakan Chat API.
Selain memanggil Chat API, aplikasi Chat juga dapat:
- Menerima dan merespons peristiwa interaksi aplikasi Chat, seperti pesan yang dikirim ke aplikasi Google Chat, secara real time.
- Berlangganan peristiwa Google Chat untuk mengambil tindakan atau merespons saat aktivitas atau perubahan tertentu terjadi di Chat, seperti pesan baru dan perubahan keanggotaan.