이 가이드에서는 list
사용 방법을 설명합니다.
SpaceEvent
리소스의 메서드
스페이스의 리소스 변경사항을 나열합니다.
SpaceEvent
리소스
스페이스의 하위 리소스를 포함하여 대상 스페이스의 변경사항을 나타냅니다.
멤버십과 같은 다양한 유형의 콘텐츠를 공유할 수 있습니다. 자세한 내용은
지원되는 이벤트 유형 및 이벤트 페이로드 목록은 eventType
및
SpaceEvent
리소스의 payload
필드
참조하세요.
요청 시점으로부터 최대 28일 전까지 이벤트를 나열할 수 있습니다. 서버
는 영향을 받은 리소스의 최신 버전이 포함된 이벤트를 반환합니다.
예를 들어 새 스페이스 멤버에 관한 이벤트를 나열하는 경우 서버에서 다음을 반환합니다.
최신 멤버십 세부정보가 포함된 리소스 Membership
개 새 제품인 경우
요청된 기간 동안 구성원이 삭제된 경우, 이벤트 페이로드에
Membership
리소스가 비어 있습니다.
이 메서드를 호출하려면 user'와 인증에 대해 자세히 알아보세요. 받는사람 목록 이벤트의 경우 인증된 사용자가 스페이스의 멤버여야 합니다.
기본 요건
Python
- 비즈니스 또는 기업 다음 액세스 권한이 있는 Google Workspace 계정 Google Chat
- 환경을 설정합니다.
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud 프로젝트를 만듭니다.
- OAuth 동의 화면 구성
- Google Chat API를 사용 설정 및 구성합니다. 아이콘, 채팅 앱 설명이 있습니다.
- <ph type="x-smartling-placeholder"></ph>
데스크톱 애플리케이션용 OAuth 클라이언트 ID 사용자 인증 정보 만들기 이 실습에서 샘플을 실행하려면
가이드에서 사용자 인증 정보를
client_secrets.json
이라는 JSON 파일로 로컬 디렉터리에 저장합니다
- <ph type="x-smartling-placeholder"></ph> 사용자 인증을 지원하는 승인 범위를 선택합니다.
스페이스 이벤트 나열
Chat 스페이스의 스페이스 이벤트를 나열하려면 다음 안내를 따르세요.
list
메서드 호출 (SpaceEvent
) 리소스를 참고하세요.- 다음을 사용하여 나열할 이벤트 유형을 지정합니다.
filter
드림 필드를 확인합니다. 이벤트 유형을 하나 이상 지정해야 하며 있습니다. 지원되는 이벤트 유형 목록은eventType
를 참고하세요. 필드입니다. - user 포함 인증의 경우 요청의 각 이벤트 유형을 지원하는 하나 이상의 승인 범위 가장 제한적인 범위를 선택하는 것이 좋습니다. 앱이 작동할 수 있습니다 범위를 선택하려면 인증 및 승인 개요
다음 코드 샘플에서는 새 멤버십에 대한 이벤트를 나열하고 메시지가 표시됩니다.
Python
- 작업 디렉터리에
chat_space_event_list.py
라는 파일을 만듭니다. chat_space_event_list.py
에 다음 코드를 포함합니다."""Lists SpaceEvent resources from the Chat API.""" from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.memberships.readonly", "https://www.googleapis.com/auth/chat.messages.readonly"] # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build( 'chat', 'v1', credentials=creds, ) # Use the service endpoint to call Chat API. result = chat.spaces().spaceEvents().list( # The space from which to list events. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. parent='spaces/SPACE', # A required filter. Filters and returns events about new memberships and messages filter='event_types:"google.workspace.chat.membership.v1.created" OR event_types:"google.workspace.chat.message.v1.created"' ).execute() # Prints details about the created space events. print(result)
코드에서 다음을 바꿉니다.
SPACE
: 스페이스 이름으로, 다음에서 가져올 수 있습니다.spaces.list
메서드 Chat API 또는 스페이스의 URL에서 가져올 수 있습니다.
작업 디렉터리에서 샘플을 빌드하고 실행합니다.
python3 chat_space_event_list.py
Chat API는
SpaceEvent
리소스
신규 멤버십 및 메시지 관련 이벤트
페이지로 나누기 맞춤설정
원하는 경우 다음 쿼리 매개변수를 전달하여 페이지로 나누기를 맞춤설정합니다.
pageSize
: 반환할SpaceEvent
리소스의 최대 개수입니다. 서비스는 이 값보다 더 적은 수의 값을 반환할 수 있습니다. 음수 값은 오류INVALID_ARGUMENT
개pageToken
: 이전 목록 공간 이벤트 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이 토큰을 제공하세요. 페이지로 나누기 시 필터 값이 페이지 토큰을 제공한 호출과 일치해야 합니다. 예기치 않은 결과가 발생할 수 있습니다