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

Ce guide explique comment utiliser la méthode get() sur la ressource Attachment de l'API Google Chat pour obtenir des métadonnées sur une 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 déclenche un événement d'interaction MESSAGE. L'événement d'interaction reçu par votre application inclut un corps de requête, qui est la charge utile JSON représentant l'événement d'interaction, y compris les pièces jointes. Les données de la pièce jointe varient selon qu'il s'agit d'un contenu importé (fichier local) ou d'un fichier stocké dans 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) jointe à un message. La ressource Attachment inclut les métadonnées de la pièce jointe, comme l'emplacement où elle est enregistrée.

Prérequis

Node.js

Obtenir une pièce jointe d'un message

Pour obtenir de manière asynchrone des métadonnées sur une pièce jointe d'un message dans Google Chat, transmettez les éléments suivants dans votre requête :

  • Spécifiez le champ d'application de l'autorisation chat.bot.
  • Appelez la méthode GetAttachment() en transmettant le name de la pièce jointe du message.

Voici comment obtenir des métadonnées sur une pièce jointe d'un message :

Node.js

chat/client-libraries/cloud/get-attachment-app-cred.js
import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to get attachment metadata with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME, MESSAGE_NAME, and ATTACHMENT_NAME here
    name: 'spaces/SPACE_NAME/messages/MESSAGE_NAME/attachments/ATTACHMENT_NAME'
  };

  // Make the request
  const response = await chatClient.getAttachment(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Pour exécuter cet exemple, remplacez spaces/SPACE_NAME/messages/ MESSAGE_NAME/attachments/ATTACHMENT_NAME par le nom de la pièce jointe du message.

L'API Chat renvoie une instance de Attachment qui détaille les métadonnées de la pièce jointe spécifiée.