- 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 anggota baru dihapus selama periode yang diminta, payload peristiwa 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 diisi. Nama resource ruang Google Chat tempat peristiwa terjadi. Format: |
Parameter kueri
Parameter | |
---|---|
pageSize |
Opsional. Jumlah maksimum peristiwa ruang yang ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Nilai negatif menampilkan error |
pageToken |
Token halaman, yang diterima dari panggilan peristiwa ruang daftar sebelumnya. Berikan atribut ini untuk mengambil halaman selanjutnya. Saat memberi nomor halaman, semua parameter lain yang diberikan untuk peristiwa ruang daftar harus cocok dengan panggilan yang menyediakan token halaman. Meneruskan nilai yang berbeda ke parameter lain dapat memberikan hasil yang tidak diharapkan. |
filter |
Wajib diisi. Filter kueri. Anda harus menentukan setidaknya satu jenis peristiwa ( Atau, Anda juga dapat memfilter menurut waktu mulai (
Untuk menentukan waktu mulai atau 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 mencantumkan peristiwa ruang.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"spaceEvents": [
{
object ( |
Kolom | |
---|---|
spaceEvents[] |
Hasil ditampilkan dalam urutan kronologis (peristiwa terlama terlebih dahulu). |
nextPageToken |
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 informasi selengkapnya, lihat Panduan otorisasi.