Obtenir les métadonnées d'une pièce jointe à un message

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

  • Python 3.6 ou version ultérieure
  • L'outil de gestion de packages pip
  • Les dernières bibliothèques clientes Google 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

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 le Attachment 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

  1. Dans votre répertoire de travail, créez un fichier nommé chat_get_message_attachment.py

  2. 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)

  3. Dans le code, remplacez spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT avec le nom de la pièce jointe.

  4. 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 du message spécifié.