Panduan di bagian ini menjelaskan cara aplikasi Google Chat dapat memanggil Chat API, yang memungkinkan aplikasi Chat melakukan hal-hal seperti membuat ruang, menambahkan orang ke dalamnya, dan memposting pesan tanpa diminta oleh peristiwa interaksi aplikasi Chat.
Autentikasi
Pemanggilan Chat API secara asinkron 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.
Resource dan metode API
Resource dan metode REST memberikan akses asinkron ke ruang Chat, anggota ruang, pesan, reaksi pesan, dan lampiran pesan.
- Ruang
Ruang adalah tempat orang dan aplikasi dapat berkomunikasi dan 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 dengan aplikasi Chat. Ruang bernama adalah tempat permanen tempat orang mengirim pesan, berbagi file, dan berkolaborasi.
Resource
Spacemerepresentasikan ruang.Ruang mendukung metode berikut:
- Buat ruang, tempat orang dan aplikasi dapat berkomunikasi dan berbagi file.
- Siapkan ruang untuk membuat ruang, dan menambahkan orang dan aplikasi Chat ke ruang tersebut.
- Dapatkan ruang untuk melihat detail tentang ruang.
- Buat daftar ruang untuk melihat daftar ruang yang dapat difilter dan diberi nomor halaman.
- Perbarui ruang untuk mengubah atribut ruang, seperti nama tampilan, deskripsi, dan panduan tampilan yang dapat dilihat pengguna.
- Menghapus spasi saat tidak diperlukan lagi.
- Temukan pesan langsung (DM) untuk menampilkan DM antara dua pengguna, atau DM antara pengguna dan aplikasi Chat yang melakukan panggilan.
- Anggota
Anggota adalah pengguna dan aplikasi Chat yang telah bergabung atau diundang ke ruang.
Resource
Membermewakili anggota.Anggota mendukung metode berikut:
- Buat keanggotaan untuk menambahkan pengguna atau aplikasi ke ruang.
- Dapatkan langganan untuk melihat detail tentang langganan.
- Keanggotaan daftar untuk melihat daftar keanggotaan dengan penomoran halaman dan dapat difilter dalam ruang.
- Menghapus keanggotaan untuk menghapus pengguna atau aplikasi dari ruang.
- Pesan
Pesan mencakup komunikasi teks dan kartu yang diposting dalam ruang. Pesan dapat dilampirkan ke file. Pengguna dapat bereaksi pada pesan dengan menambahkan emoji ke pesan.
Resource
Messagemerepresentasikan pesan.Pesan mendukung metode berikut:
- Buat pesan untuk memposting pesan teks atau kartu. Anda juga dapat memulai atau membalas rangkaian pesan.
- Menerima pesan untuk mendapatkan detail tentang pesan, seperti kapan pesan dikirim atau isi pesan.
- Buat daftar pesan untuk melihat daftar pesan dengan penomoran halaman dan dapat difilter dalam ruang.
- Perbarui pesan untuk mengubah atribut pesan, misalnya isi pesannya. Anda juga dapat menambahkan teks ke pesan kartu, atau kartu ke pesan teks.
- Menghapus pesan saat tidak diperlukan lagi.
- Reaksi
Reaksi mewakili emoji yang digunakan orang untuk bereaksi terhadap pesan, seperti 👍, BROWSER, dan ]{}{}.
Resource
Reactionmerepresentasikan reaksi.Reaksi mendukung metode berikut:
- Buat reaksi untuk menambahkan emoji ke pesan.
- Menampilkan daftar reaksi untuk melihat daftar reaksi dengan penomoran halaman dan dapat difilter terhadap pesan.
- Hapus reaksi untuk menghapus emoji dari pesan.
- Media dan lampiran
Media mewakili file yang diupload ke Google Chat, seperti gambar, video, dan dokumen.
Resource
Mediamewakili media yang dilampirkan ke pesan.Lampiran adalah instance media (file) yang dilampirkan ke pesan.
Resource
Attachmentmerepresentasikan lampiran. Lampiran berisi media dan metadata terkait yang dilampirkan ke pesan.Media dan lampiran mendukung metode berikut:
- Upload media sebagai lampiran untuk mengupload media ke Google Chat, lalu melampirkannya ke pesan.
- Download media sebagai lampiran untuk mendownload media dari Google Chat sebagai file biner.
- Mendapatkan lampiran untuk mengambil metadata tentang lampiran pesan.
Menemukan dokumen discovery
Dokumen penemuan untuk API ini terletak di URL berikut: