Ce guide explique comment utiliser la méthode get
sur la ressource Media
du
API Google Chat pour obtenir des métadonnées sur une pièce jointe à un message. La réponse est
de l'instance
Ressource Attachment
.
Lorsque l'utilisateur envoie un message à votre application, Google Chat envoie une
Événement d'interaction MESSAGE
.
L'événement d'interaction reçu par votre application inclut un corps de requête, qui correspond au
Charge utile JSON représentant l'événement d'interaction, y compris les pièces jointes. La
les données de la pièce jointe varient selon que la pièce jointe est
contenu importé (fichier local) ou s'il s'agit d'un fichier stocké sur Drive. La
Ressource Media
représente un fichier importé dans Google Chat, comme des images, des vidéos et des documents.
La
Ressource Attachment
représente une instance de contenu multimédia (un fichier) joint à un message. Attachment
ressource inclut les métadonnées sur le rattachement, telles que
où elles sont enregistrées.
Prérequis
Python
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Configurez votre environnement:
<ph type="x-smartling-placeholder">
- </ph>
- Créez un projet Google Cloud.
- Configurer l'écran de consentement OAuth
- activer et configurer l'API Google Chat à l'aide d'un nom ; et la description de votre application Chat.
- <ph type="x-smartling-placeholder"></ph>
Créez des identifiants client OAuth pour une application de bureau. Pour exécuter l'exemple
enregistrez les identifiants dans un fichier JSON nommé
client_secrets.json
dans votre dans votre répertoire local.
- <ph type="x-smartling-placeholder"></ph> Choisissez un niveau d'autorisation compatible avec l'authentification des utilisateurs.
Récupérer 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 demande:
- Spécifiez le champ d'application de l'autorisation
chat.bot
. - Appelez la méthode
Méthode
get
leAttachment
ressource, - Transmettez l'identifiant
name
de la pièce jointe au message.
Pour obtenir les métadonnées d'une pièce jointe à un message, procédez comme suit:
Python
- Dans votre répertoire de travail, créez un fichier nommé
chat_get_message_attachment.py
Ajoutez 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
avec 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
concernant la pièce jointe spécifiée.