Google Chat 스페이스 일정 세부정보 보기

이 가이드에서는 Google Chat API의 SpaceEvent 리소스에서 get 메서드를 사용하여 Google Chat 스페이스의 이벤트에 관한 세부정보를 가져오는 방법을 설명합니다.

SpaceEvent 리소스는 스페이스 또는 메시지, 반응, 멤버십과 같은 하위 리소스의 변경사항을 나타냅니다. 지원되는 이벤트 유형에 대한 자세한 내용은 SpaceEvent 리소스 참조 문서의 eventType 필드를 확인하세요.

요청 시간으로부터 최대 28일 전에 이벤트를 요청할 수 있습니다. 이벤트에는 변경된 최신 버전의 리소스가 포함됩니다. 예를 들어 새 메시지에 대한 이벤트를 요청했지만 메시지가 나중에 업데이트된 경우 서버는 이벤트 페이로드에 업데이트된 Message 리소스를 반환합니다.

이 메서드를 호출하려면 사용자 인증을 사용해야 합니다. 이벤트를 가져오려면 인증된 사용자가 이벤트가 발생한 스페이스의 구성원이어야 합니다.

기본 요건

Python

  • Python 3.6 이상
  • pip 패키지 관리 도구
  • 최신 Python용 Google 클라이언트 라이브러리입니다. 이를 설치하거나 업데이트하려면 명령줄 인터페이스에서 다음 명령어를 실행합니다.

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    
  • Google Chat API가 사용 설정 및 구성된 Google Cloud 프로젝트 단계는 Google Chat 앱 빌드를 참고하세요.
  • 채팅 앱에 구성된 승인. 스페이스 이벤트를 가져오려면 이벤트 유형을 지원하는 범위의 사용자 인증이 필요합니다. 범위를 선택하려면 인증 및 승인 개요를 참조하세요.

스페이스 일정에 관해 자세히 알아보기

Google Chat에서 SpaceEvent에 관한 세부정보를 확인하려면 다음 단계를 따르세요.

  • SpaceEvent 리소스에서 get 메서드를 호출합니다.
  • SpaceEventname를 전달하여 가져옵니다. Google Chat의 SpaceEvent 리소스에서 SpaceEvent 이름을 가져옵니다.
  • 사용자 인증을 사용하면 요청에서 이벤트 유형을 지원하는 승인 범위를 지정합니다. 앱이 작동할 수 있는 가장 제한적인 범위를 선택하는 것이 좋습니다.

사용자 인증과 함께 SpaceEvent를 가져오는 방법은 다음과 같습니다.

Python

  1. 작업 디렉터리에서 chat_space_event_get.py라는 파일을 만듭니다.
  2. chat_space_event_get.py에 다음 코드를 포함합니다.

    """Gets a SpaceEvent resource 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 = ['SCOPE']
    
    # 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()
        .get(
            # The space event to get.
            #
            # Replace SPACE with a space name.
            # Obtain the space name from the spaces resource of Chat API,
            # or from a space's URL.
            #
            # Replace SPACE_EVENT with a SpaceEvent name.
            # Obtain the spaceEvent name from the SpaceEvent resource of
            # Chat API.
            name='spaces/SPACE/spaceEvents/SPACE_EVENT'
        )
        .execute()
    )
    
    # Prints details about the created spaceEvent.
    print(result)
    
  3. 코드에서 다음을 바꿉니다.

    • SCOPE: 이벤트 유형에 따른 승인 범위입니다. 예를 들어 새 멤버십에 관한 스페이스 이벤트를 받는 경우 https://www.googleapis.com/auth/chat.memberships.readonly 형식의 chat.memberships.readonly 범위를 사용합니다. spaces.spaceEvents.list 메서드에서 이벤트 유형을 가져올 수 있습니다. 이 메서드의 사용 방법은 스페이스의 이벤트 나열을 참고하세요.
    • SPACE: Chat API의 spaces.list 메서드 또는 스페이스 URL에서 가져올 수 있는 스페이스 이름입니다.
    • SPACE_EVENT: spaces.spaceEvents.list 메서드에서 가져올 수 있는 스페이스 이벤트의 이름입니다.
  4. 작업 디렉터리에서 샘플을 빌드하고 실행합니다.

    python3 chat_space_event_get.py
    

Chat API는 이벤트에 대한 세부정보와 함께 SpaceEvent 인스턴스를 반환합니다.