Google Chat 스페이스의 이벤트를 나열합니다. 각 이벤트에 대한 payload에는 Chat 리소스의 최신 버전이 포함됩니다. 예를 들어 새 스페이스 멤버에 관한 일정을 나열하면 서버에서 최신 멤버십 세부정보가 포함된 Membership
리소스를 반환합니다. 요청된 기간 동안 새 구성원이 삭제된 경우 이벤트 페이로드에 빈 Membership
리소스가 포함됩니다.
사용자 인증이 필요합니다. 이벤트를 나열하려면 인증된 사용자가 스페이스 구성원이어야 합니다.
예시는 Google Chat 스페이스의 이벤트 나열을 참고하세요.
HTTP 요청
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 이벤트가 발생한 Google Chat 스페이스의 리소스 이름입니다. 형식: |
쿼리 매개변수
매개변수 | |
---|---|
pageSize |
선택사항입니다. 반환되는 스페이스 이벤트의 최대 개수입니다. 서비스는 이 값보다 더 적은 수의 값을 반환할 수 있습니다. 음수 값은 |
pageToken |
이전 목록 공간 이벤트 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나눌 때 목록 공간 이벤트에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예상치 못한 결과가 발생할 수 있습니다. |
filter |
필수 항목입니다. 쿼리 필터 has 원하는 경우 시작 시간 (
시작 시간 또는 종료 시간을 지정하려면 RFC-3339에서 같음 예를 들어 유효한 쿼리는 다음과 같습니다.
다음 쿼리가 잘못되었습니다.
잘못된 쿼리는 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
스페이스 이벤트 나열을 위한 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"spaceEvents": [
{
object ( |
필드 | |
---|---|
spaceEvents[] |
결과는 시간순 (가장 오래된 이벤트순)으로 반환됩니다. |
nextPageToken |
더 많은 이벤트를 가져오는 데 사용되는 연속 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다. |
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
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
자세한 내용은 승인 가이드를 참조하세요.