List events from a Google Chat space

This guide explains how to use the list method on the SpaceEvent resource of the Google Chat API to list changes to resources in a space.

The SpaceEvent resource represents a change to the target space, including child resources of the space such as messages, reactions, and memberships. For more information about the list of event types and event payloads supported, see the eventType and payload fields of the SpaceEvent resource reference documentation.

You can list events up to 28 days before the time of the request. The server returns events that contain the most recent version of the affected resource. For example, if you list events about new space members, the server returns Membership resources that contain the latest membership details. If new members were removed during the requested period, the event payload contains an empty Membership resource.

To call this method, you must use user authentication. To list events from a space, the authenticated user must be a member of the space.



  • Python 3.6 or greater
  • The pip package management tool
  • The latest Google client libraries for Python. To install or update them, run the following command in your command-line interface:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • A Google Cloud project with the Google Chat API enabled and configured. For steps, see Build a Google Chat app.
  • Authorization configured for the Chat app. Listing SpaceEvent resources supports the following authentication methods:

List space events

To list space events from a Chat space, do the following:

In the following code sample, you list events about new memberships and messages in a space.


  1. In your working directory, create a file named
  2. Include the following code in

    """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 = ["",
    # 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(
    # 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.
        # A required filter. Filters and returns events about new memberships and messages
        filter='event_types:"" OR event_types:""'
    # Prints details about the created space events.
  3. In the code, replace the following:

    • SPACE: a space name, which you can obtain from the spaces.list method in the Chat API, or from a space's URL.
  4. In your working directory, build and run the sample:


The Chat API returns a list of SpaceEvent resources events about new memberships and messages.

Customize pagination

Optionally, pass the following query parameters to customize pagination:

  • pageSize: The maximum number of SpaceEvent resources to return. The service might return fewer than this value. Negative values return an INVALID_ARGUMENT error.
  • pageToken: A page token, received from a previous list space events call. Provide this token to retrieve the subsequent page. When paginating, the filter value should match the call that provided the page token. Passing a different value might lead to unexpected results.