Mencantumkan peristiwa dari ruang Google Chat. Untuk setiap peristiwa, payload berisi versi terbaru resource Chat. 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 akan berisi resource Membership kosong.
Memerlukan autentikasi pengguna. Untuk mencantumkan peristiwa, pengguna terautentikasi harus menjadi anggota ruang.
Opsional. Jumlah maksimum peristiwa ruang yang ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini.
Nilai negatif menampilkan error INVALID_ARGUMENT.
pageToken
string
Opsional. Token halaman, 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 menyebabkan hasil yang tidak terduga.
filter
string
Wajib. Filter kueri.
Anda harus menentukan minimal satu jenis peristiwa (eventType) menggunakan operator has :. Untuk memfilter menurut beberapa jenis peristiwa, gunakan operator OR. Hapus jenis peristiwa batch di filter Anda. Permintaan akan otomatis menampilkan peristiwa batch terkait. Misalnya, jika Anda memfilter menurut reaksi baru (google.workspace.chat.reaction.v1.created), server juga akan menampilkan peristiwa reaksi baru batch (google.workspace.chat.reaction.v1.batchCreated). Untuk mengetahui daftar jenis peristiwa yang didukung, lihat dokumentasi referensi SpaceEvents.
Secara opsional, Anda juga dapat memfilter berdasarkan waktu mulai (startTime) dan waktu berakhir (endTime):
startTime: Stempel waktu eksklusif tempat Anda mulai mencantumkan peristiwa ruang. Anda dapat mencantumkan peristiwa yang terjadi hingga 28 hari yang lalu. Jika tidak ditentukan, daftar peristiwa ruang dari 28 hari terakhir.
endTime: Stempel waktu inklusif hingga peristiwa ruang dicantumkan. Jika tidak ditentukan, daftar peristiwa hingga waktu permintaan.
Untuk menentukan waktu mulai atau waktu berakhir, gunakan operator sama dengan = dan format dalam RFC-3339. Untuk memfilter menurut startTime dan endTime, gunakan operator AND.
Misalnya, kueri berikut valid:
startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"
startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")
Kueri berikut tidak valid:
startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"
eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"
Kueri yang tidak valid ditolak oleh server dengan error INVALID_ARGUMENT.
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons untuk listingan peristiwa ruang.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Hasil ditampilkan dalam urutan kronologis (peristiwa terlama terlebih dahulu). Catatan: Kolom permissionSettings tidak ditampilkan dalam objek Ruang untuk permintaan daftar.
nextPageToken
string
Token kelanjutan yang digunakan untuk mengambil lebih banyak peristiwa. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-02-27 UTC."],[[["Lists events from a specified Google Chat space, including new members, messages, and reactions, with the payload containing the most recent version of the resource."],["Requires user authentication and membership in the space to list events, returning data chronologically with optional pagination."],["Allows filtering by event types, start time, and end time to refine the results of the listed events."],["The response includes an array of space events and a token for retrieving subsequent pages if available."],["Needs specific authorization scopes for accessing and retrieving the chat space data."]]],["This documentation outlines how to list events from a Google Chat space using the `GET` method. Key actions include: specifying the space via the `parent` path parameter, filtering events by type and time using the `filter` query parameter, and setting the number of events returned with `pageSize`. `pageToken` is used for pagination. Authentication requires user membership in the space and specific OAuth scopes. The response body includes a list of `spaceEvents` and a `nextPageToken` for further results.\n"]]
