Lista zdarzeń z pokoju Google Chat. W przypadku każdego zdarzenia ładunek zawiera najnowszą wersję zasobu czatu. Jeśli na przykład wyświetlisz listę zdarzeń dotyczących nowych członków pokoju, serwer zwróci zasoby Membership zawierające najnowsze informacje o członkostwie. Jeśli w okresie objętym prośbą o dane nowi członkowie zostali usunięci, ładunek zdarzenia zawiera pusty zasób Membership.
Wymaga uwierzytelniania użytkownika. Aby wyświetlić listę wydarzeń, uwierzytelniony użytkownik musi być członkiem pokoju.
Wymagany. Nazwa zasobu pokoju Google Chat, w którym wystąpiły zdarzenia.
Format: spaces/{space}.
Parametry zapytania
Parametry
pageSize
integer
Opcjonalnie: Maksymalna liczba zwracanych zdarzeń dotyczących przestrzeni. Usługa może zwrócić mniej niż ta wartość.
Wartości ujemne zwracają błąd INVALID_ARGUMENT.
pageToken
string
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania zdarzeń w pokoju. Podaj ten parametr, aby pobrać kolejną stronę.
Podczas podziału na strony wszystkie inne parametry podawane do zdarzeń listowania miejsc na stronie muszą być zgodne z wywołaniem, które dostarczyło token strony. Przekazywanie różnych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników.
filter
string
Wymagany. Filtr zapytania.
Musisz określić co najmniej 1 typ zdarzenia (eventType) za pomocą operatora has :. Aby filtrować według wielu typów zdarzeń, użyj operatora OR. Pomiń w filtrze typy zdarzeń zbiorczych. Żądanie automatycznie zwraca wszystkie powiązane zdarzenia zbiorcze. Jeśli na przykład filtrujesz według nowych reakcji (google.workspace.chat.reaction.v1.created), serwer zwraca też zdarzenia dotyczące nowych reakcji (google.workspace.chat.reaction.v1.batchCreated). Listę obsługiwanych typów zdarzeń znajdziesz w SpaceEvents dokumentacji referencyjnej.
Opcjonalnie możesz też filtrować według czasu rozpoczęcia (startTime) i czasu zakończenia (endTime):
startTime: sygnatura czasowa, od której należy zacząć wyświetlać wydarzenia w ramach listy miejsc. Możesz wyświetlić listę zdarzeń, które miały miejsce do 28 dni temu. Jeśli nie jest określone, wyświetla się lista zdarzeń w czasie rzeczywistym z ostatnich 28 dni.
endTime: sygnatura czasowa, do której są wyświetlane zdarzenia w pokoju. Jeśli nie określono tego parametru, lista zawiera zdarzenia do momentu wysłania żądania.
Aby określić czas rozpoczęcia lub zakończenia, użyj operatora równa się = i formatu RFC-3339. Aby filtrować według właściwości startTime i endTime, użyj operatora AND.
Na przykład te zapytania są prawidłowe:
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")
Te zapytania są nieprawidłowe:
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"
Wyniki są zwracane w kolejności chronologicznej (najpierw najstarsze zdarzenie). Uwaga: w przypadku żądań listy pole permissionSettings nie jest zwracane w obiekcie pokoju.
nextPageToken
string
Token kontynuacji służący do pobierania kolejnych zdarzeń. Jeśli pominiesz to pole, nie będzie kolejnych stron.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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"]]
