List messages

Python

• 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-httplib2 google-auth-oauthlib oauth2client
  

• A published Chat app. To create and publish a Chat app, see Build a Google Chat app.

• Authorization configured for the Chat app. Listing messages requires User authentication with the chat.messages.readonly or chat.messages authorization scope.

Python

1. In your working directory, create a file named chat_messages_list.py.

2. Include the following code in chat_messages_list.py:

   import os.path
   
   from google.auth.transport.requests import Request
   from google.oauth2.credentials import Credentials
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   from googleapiclient.errors import HttpError
   
   # 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.messages.readonly"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then lists messages in a space sent after March 16, 2023.
       '''
   
       # 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().messages().list(
   
             # The space for which to list messages.
             parent = 'spaces/SPACE',
   
             # An optional filter that returns messages
             # created after March 16, 2023.
             filter = 'createTime > "2023-03-16T00:00:00-00:00"'
   
         ).execute()
   
       # Prints details about the created membership.
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. In the code, replace SPACE with 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:

   python3 chat_messages_list.py