Ringkasan Google Chat API

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

Memanggil 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 dan aplikasi Chat. Ruang bernama adalah tempat tetap tempat orang mengirim pesan, berbagi file, dan berkolaborasi.

Resource spaces mewakili ruang.

Ruang mendukung metode berikut:

  • Buat ruang, tempat orang dan aplikasi dapat berkomunikasi dan berbagi file.
  • Siapkan ruang untuk membuat ruang, serta menambahkan orang dan aplikasi Chat ke ruang tersebut.
  • Dapatkan ruang untuk melihat detail tentang ruang.
  • Buat daftar spasi untuk melihat daftar ruang yang telah dipaginasi dan dapat difilter.
  • Perbarui ruang untuk mengubah atribut ruang, seperti nama tampilan, deskripsi, dan panduan yang terlihat oleh pengguna.
  • Menghapus ruang 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 spaces.members mewakili anggota.

Anggota mendukung metode berikut:

Pesan

Pesan mencakup komunikasi teks dan kartu yang diposting di ruang. Pesan dapat memiliki file terlampir. Pengguna dapat bereaksi pada pesan dengan menambahkan emoji ke pesan.

Resource spaces.messages mewakili pesan.

Pesan mendukung metode berikut:

Reaksi

Reaksi mewakili emoji yang digunakan orang untuk bereaksi terhadap suatu pesan, seperti 👍, tool, dan STRING.

Resource spaces.messages.reactions mewakili reaksi.

Reaksi mendukung metode berikut:

  • Buat reaksi untuk menambahkan emoji ke pesan.
  • Buat daftar reaksi untuk melihat daftar reaksi yang telah diberi nomor 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 media mewakili media yang dilampirkan ke pesan.

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

Resource spaces.messages.attachments mewakili lampiran. Lampiran menyertakan media dan metadata terkait yang dilampirkan pada pesan.

Media dan lampiran mendukung metode berikut:

Acara ruang

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

Resource spaces.spaceEvent mewakili peristiwa ruang.

Peristiwa ruang mendukung metode berikut:

Status baca pengguna (Pratinjau Developer)

Status baca pengguna adalah resource singleton yang mewakili detail tentang pesan yang terakhir dibaca dari pengguna tertentu di ruang Google Chat atau thread pesan.

Resource users.spaces mewakili status baca pengguna dalam ruang.

Resource users.spaces.threads mewakili status baca pengguna dalam rangkaian pesan.

Status baca pengguna mendukung metode berikut: