- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Cobalah!
Mencantumkan peristiwa dari ruang Google Chat. Untuk setiap peristiwa, payload berisi resource Chat versi terbaru. Misalnya, jika Anda mencantumkan peristiwa tentang anggota ruang baru, server akan menampilkan resource Membership
yang berisi detail keanggotaan terbaru. Jika pelanggan baru dihapus selama periode yang diminta, payload peristiwa akan berisi resource Membership
kosong.
Memerlukan autentikasi pengguna. Untuk mencantumkan peristiwa, pengguna yang diautentikasi harus menjadi anggota ruang.
Sebagai contoh, lihat Mencantumkan peristiwa dari ruang Google Chat.
Permintaan HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
parent |
Wajib. Nama resource ruang Google Chat tempat peristiwa terjadi. Format: |
Parameter kueri
Parameter | |
---|---|
page |
Opsional. Jumlah maksimum peristiwa ruang yang ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Nilai negatif menampilkan error |
page |
Token halaman, yang diterima dari panggilan peristiwa ruang daftar sebelumnya. Berikan ini untuk mengambil halaman berikutnya. Saat melakukan penomoran halaman, semua parameter lain yang diberikan untuk mencantumkan peristiwa ruang harus sesuai dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda ke parameter lain dapat memberikan hasil yang tidak diharapkan. |
filter |
Wajib. Filter kueri. Anda harus menentukan minimal satu jenis peristiwa ( Secara opsional, Anda juga dapat memfilter berdasarkan waktu mulai (
Untuk menentukan waktu mulai atau waktu berakhir, gunakan operator sama dengan Misalnya, kueri berikut valid:
Kueri berikut tidak valid:
Kueri yang tidak valid ditolak oleh server dengan error |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons untuk listingan peristiwa ruang.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"spaceEvents": [
{
object ( |
Kolom | |
---|---|
space |
Hasil ditampilkan dalam urutan kronologis (peristiwa terlama terlebih dahulu). Catatan: Kolom |
next |
Token lanjutan digunakan untuk mengambil lebih banyak peristiwa. Jika kolom ini dihilangkan, tidak ada halaman berikutnya. |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.