Mengembangkan dengan Google Chat

Halaman ini memberikan ringkasan tentang Google Chat API dan aplikasi Google Chat.

Ringkasan Google Chat API

Chat API terdiri dari layanan gRPC atau metode dan resource REST yang memberikan akses ke Chat, termasuk ruang, anggota ruang, pesan, reaksi pesan, lampiran pesan, peristiwa ruang, dan status sudah dibaca pengguna.

Konsep

Bagian berikut menentukan layanan, resource, dan metode untuk Chat API:

Ruang

Ruang adalah tempat orang dan aplikasi dapat melakukan percakapan dan berbagi file. Ada beberapa jenis ruang. Pesan langsung (DM) adalah percakapan personal 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:

• Referensi RPC
• Referensi REST

Untuk contoh penggunaan, lihat:

• Membuat ruang
• Menyiapkan ruang
• Mendapatkan ruang
• Mencantumkan ruang
• Memperbarui ruang
• Menghapus ruang
• Menemukan pesan langsung (DM)

Anggota

Anggota adalah pengguna dan aplikasi Chat yang telah bergabung atau diundang ke ruang.

Referensi resource:

• Referensi RPC
• Referensi REST

Untuk contoh penggunaan, lihat:

• Membuat keanggotaan
• Mendapatkan langganan
• Mencantumkan langganan
• Memperbarui langganan
• Menghapus keanggotaan

Pesan

Pesan mencakup teks dan kartu komunikasi yang diposting di ruang. Pesan dapat memiliki file yang dilampirkan. Orang dapat bereaksi terhadap pesan dengan menambahkan emoji ke pesan tersebut.

Referensi resource:

• Referensi RPC
• Referensi REST

Untuk contoh penggunaan, lihat:

• Membuat pesan
• Mendapatkan pesan
• Mencantumkan pesan
• Memperbarui pesan
• Menghapus pesan

Reaksi

Reaksi menampilkan emoji yang digunakan orang untuk bereaksi terhadap pesan, seperti 👍, 🚲, dan 🌞.

Referensi resource:

• Referensi RPC
• Referensi REST

Untuk contoh penggunaan, lihat:

• Membuat reaksi
• Mencantumkan reaksi
• Menghapus reaksi

Emoji kustom

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:

• Referensi RPC
• Referensi REST

Media dan lampiran

Media mewakili file yang diupload ke Google Chat, seperti gambar, video, dan dokumen.

Referensi resource media (Tidak tersedia di RPC):

• Referensi REST

Lampiran adalah instance media (file) yang dilampirkan ke pesan.

Referensi resource:

• Referensi RPC
• Referensi REST

Untuk contoh penggunaan, lihat:

• Mengupload media sebagai lampiran
• Mendownload media sebagai lampiran
• Mendapatkan lampiran

Peristiwa ruang

Peristiwa ruang mewakili perubahan pada ruang atau resource turunannya, termasuk anggota, pesan, dan reaksinya.

Referensi resource:

• Referensi RPC
• Referensi REST

Untuk contoh penggunaan, lihat:

• Mendapatkan status sudah dibaca ruang
• Memperbarui status sudah dibaca ruang
• Mendapatkan status sudah dibaca rangkaian pesan

Status sudah dibaca pengguna

Status sudah dibaca pengguna adalah resource singleton yang merepresentasikan detail tentang pesan terakhir yang dibaca oleh pengguna tertentu di ruang Google Chat atau rangkaian pesan.

Referensi resource status baca ruang:

• Referensi RPC
• Referensi REST

Referensi resource status bacaan thread:

• Referensi RPC
• Referensi REST

Untuk contoh penggunaan, lihat:

• Mendapatkan status sudah dibaca ruang
• Memperbarui status sudah dibaca ruang
• Mendapatkan status sudah dibaca rangkaian pesan

Setelan notifikasi ruang pengguna

Setelan notifikasi ruang pengguna adalah resource singleton yang merepresentasikan setelan notifikasi pengguna tertentu di ruang Google Chat.

Referensi resource:

• Referensi RPC
• Referensi REST

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 lebih lanjut autentikasi di Chat, lihat Ringkasan autentikasi.

Library klien

Cara yang direkomendasikan bagi sebagian besar developer untuk memanggil Google Chat API adalah dengan Library Klien Cloud yang didukung secara resmi untuk bahasa pilihan Anda, seperti Python, Java, atau Node.js.

Jika Anda membuat kode dengan Google Apps Script, gunakan layanan Chat Lanjutan daripada menginstal library klien.

Membangun aplikasi Chat

Chat API memungkinkan Anda membuat aplikasi Google Chat yang menghadirkan layanan dan resource Anda langsung ke Google Chat. Anda dapat membuat aplikasi Chat untuk melakukan salah satu hal berikut:

• Mengambil informasi berdasarkan kueri teks bebas atau terstruktur yang dimasukkan oleh pengguna.
• Membuat laporan insiden atau artefak lainnya, menggunakan informasi yang diberikan oleh pengguna.
• Meningkatkan kolaborasi tim, seperti menyediakan "memori tim" atau menjadwalkan sumber daya.

Anda dapat mendesain aplikasi Chat menggunakan beberapa gaya arsitektur yang berbeda, termasuk yang berikut:

• Aplikasi interaktif: Merespons interaksi pengguna, seperti sebutan @atau perintah garis miring, dan menyajikan informasi atau memandu pengguna melalui alur kerja dengan kartu dan dialog.
• Aplikasi command line atau webhook: Mengirim pesan proaktif, seperti alarm atau notifikasi, dari sistem lain ke dalam ruang. Pengguna tidak dapat berinteraksi langsung dengan jenis aplikasi ini.
• Aplikasi berbasis peristiwa: Berlangganan dan bereaksi terhadap aktivitas di ruang Chat, seperti anggota baru yang bergabung. Sebagai respons terhadap suatu peristiwa, aplikasi dapat mengirim pesan atau melakukan tindakan lain.

Untuk mengetahui detail tentang cara mendesain aplikasi Chat, lihat Memilih arsitektur aplikasi Google Chat.

Topik terkait

• Jelajahi contoh aplikasi Google Chat.
• Buat aplikasi Google Chat interaktif.
• Pilih arsitektur aplikasi Google Chat.