Ce guide explique comment utiliser la méthode get
sur la ressource Media
de l'API Google Chat pour obtenir des métadonnées sur la pièce jointe d'un message. La réponse est une instance de la ressource Attachment
.
Lorsque l'utilisateur envoie un message à votre application, Google Chat envoie un événement d'interaction MESSAGE
.
L'événement d'interaction reçu par votre application inclut un corps de requête, qui correspond à la charge utile JSON représentant l'événement d'interaction, y compris les éventuelles pièces jointes. Les données de la pièce jointe diffèrent selon qu'il s'agit d'un contenu importé (fichier local) ou d'un fichier stocké sur Drive. La ressource Media
représente un fichier importé dans Google Chat, par exemple des images, des vidéos et des documents.
La ressource Attachment
représente une instance de contenu multimédia (fichier) jointe à un message. La ressource Attachment
inclut les métadonnées sur le rattachement, telles que son emplacement d'enregistrement.
Prérequis
Python
- Python 3.6 ou version ultérieure
- L'outil de gestion des packages pip
Les dernières bibliothèques clientes Google pour Python. Pour les installer ou les mettre à jour, exécutez la commande suivante dans votre interface de ligne de commande:
pip3 install --upgrade google-api-python-client google-auth-oauthlib google-auth
- Un projet Google Cloud avec l'API Google Chat activée et configurée Pour connaître la procédure à suivre, consultez Créer une application Google Chat.
Autorisation configurée pour l'application Chat. L'obtention d'un message nécessite l'authentification de l'application avec le niveau d'autorisation
chat.bot
.
Recevoir une pièce jointe
Pour obtenir de manière asynchrone les métadonnées d'une pièce jointe dans Google Chat, transmettez les éléments suivants dans votre requête:
- Spécifiez le champ d'application des autorisations
chat.bot
. - Appelez la méthode
get
sur la ressourceAttachment
. - Transmettez le
name
de la pièce jointe du message.
Pour obtenir les métadonnées d'une pièce jointe, procédez comme suit:
Python
- Dans votre répertoire de travail, créez un fichier nommé
chat_get_message_attachment.py
. Incluez le code suivant dans
chat_get_message_attachment.py
:from google.oauth2 import service_account from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=CREDENTIALS) # Get a Chat message. result = chat.spaces().messages().attachments().get( # The message 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 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/attachments/ATTACHMENT' ).execute() # Print Chat API's response in your command line interface. print(result)
Dans le code, remplacez
spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT
par le nom de la pièce jointe.Dans votre répertoire de travail, créez et exécutez l'exemple:
python3 chat_get_message_attachment.py
L'API Chat renvoie une instance de Attachment
qui détaille les métadonnées sur la pièce jointe de message spécifiée.
Articles associés
- Importer des contenus multimédias en tant que pièce jointe
- Télécharger des contenus multimédias en tant que pièce jointe