Перечисляет события из пространства Google Chat. Для каждого события полезные данные содержат самую последнюю версию ресурса Chat. Например, если вы перечислите события о новых участниках пространства, сервер вернет ресурсы Membership , содержащие последние сведения о членстве. Если новые участники были удалены в течение запрошенного периода, полезные данные события будут содержать пустой ресурс Membership .
Требует аутентификации пользователя . Чтобы составить список событий, аутентифицированный пользователь должен быть участником пространства.
Необязательный. Возвращено максимальное количество космических событий. Служба может вернуть меньше этого значения.
Отрицательные значения возвращают ошибку INVALID_ARGUMENT .
pageToken
string
Токен страницы, полученный в результате предыдущего вызова событий пространства списка. Предоставьте это, чтобы получить следующую страницу.
При разбиении на страницы все остальные параметры, предоставляемые для перечисления событий пространства, должны соответствовать вызову, который предоставил токен страницы. Передача других значений другим параметрам может привести к неожиданным результатам.
filter
string
Необходимый. Фильтр запроса.
Вы должны указать хотя бы один тип события ( eventType ), используя оператор has : Для фильтрации по нескольким типам событий используйте оператор OR . Исключите типы пакетных событий в фильтре. Запрос автоматически возвращает все связанные пакетные события. Например, если вы фильтруете по новым реакциям ( google.workspace.chat.reaction.v1.created ), сервер также возвращает пакетные события новых реакций ( google.workspace.chat.reaction.v1.batchCreated ). Список поддерживаемых типов событий см. в справочной документации SpaceEvents .
При желании вы также можете фильтровать по времени начала ( startTime ) и времени окончания ( endTime ):
startTime : эксклюзивная временная метка, с которой начинается список космических событий. Вы можете перечислить события, произошедшие не более 28 дней назад. Если не указано, перечисляет космические события за последние 28 дней.
endTime : включающая временная метка, до которой будут перечислены космические события. Если не указано, выводит список событий до момента запроса.
Чтобы указать время начала или окончания, используйте оператор равенства = и формат в RFC-3339 . Чтобы фильтровать как по startTime , так и endTime , используйте оператор AND .
Например, допустимы следующие запросы:
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")
Следующие запросы недействительны:
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"
Недействительные запросы отклоняются сервером с ошибкой INVALID_ARGUMENT .
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответное сообщение для перечисления космических событий.
В случае успеха тело ответа содержит данные следующей структуры:
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-01-07 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"]]
