Delete a message

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. Deleting a message supports both of the following authentication methods:

  • User authentication, with the chat.messages authorization scope, can delete messages created by that user. If you're a Space Manager, you might be able to delete other messages. For more information, see Learn about your role as a Space Manager.
  • App authentication, with the chat.bot authorization scope, can delete messages created by that app using its service account.

Python

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

2. Include the following code in chat_message_delete_user.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"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then deletes a message.
       '''
   
       # 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().delete(
   
           # The message to delete.
           #
           # Replace SPACE with a space name.
           # Obtain the space name from the spaces resource of Chat API,
           # or from a space's URL.
           #
           # Replace MESSAGE with a message name.
           # Obtain the message name from the response body returned
           # after creating a message asynchronously with Chat REST API.
           name = 'spaces/SPACE/messages/MESSAGE'
   
       ).execute()
   
       # Prints details about the created membership.
       print(result)
   
   if __name__ == '__main__':
       main()
   

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.
   • MESSAGE: a message name, which you can obtain from the response body returned after creating a message asynchronously with the Chat API, or with the custom name assigned to the message at creation.

4. In your working directory, build and run the sample:

   python3 chat_message_delete_user.py
   

Python

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

2. Include the following code in chat_delete_message_app.py:

   from httplib2 import Http
   from oauth2client.service_account import ServiceAccountCredentials
   from apiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = ['https://www.googleapis.com/auth/chat.bot']
   
   # Specify service account details.
   CREDENTIALS = ServiceAccountCredentials.from_json_keyfile_name(
     'credentials.json', SCOPES)
   
   # Build the URI and authenticate with the service account.
   chat = build('chat', 'v1', http=CREDENTIALS.authorize(Http()))
   
   # Delete a Chat message.
   result = chat.spaces().messages().delete(
   
     # The message to delete.
     #
     # Replace SPACE with a space name.
     # Obtain the space name from the spaces resource of Chat API,
     # or from a space's URL.
     #
     # Replace MESSAGE with a message name.
     # Obtain the message name from the response body returned
     # after creating a message asynchronously with Chat REST API.
     name='spaces/SPACE/messages/MESSAGE'
   
   ).execute()
   
   # Print Chat API's response in your command line interface.
   # When deleting a message, the response body is empty.
   print(result)
   

3. In the code, replace the following:

   • SPACE: the name of the space where the message is posted, which you can obtain from the spaces.list method in the Chat API, or from a space's URL.
   • MESSAGE: the message name, which you can obtain from the response body returned after creating a message asynchronously with the Chat API, or with the custom name assigned to the message at creation.

4. In your working directory, build and run the sample:

   python3 chat_delete_message_app.py