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 de 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 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 sont différentes 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, 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. La ressource Attachment inclut les métadonnées sur la pièce jointe, telles que l'emplacement où elle est enregistrée.

Prérequis

Node.js

Obtenir une pièce jointe de message

Pour obtenir de manière asynchrone les métadonnées d'une pièce jointe de 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 l'name de la pièce jointe du message.

Pour obtenir les métadonnées d'une pièce jointe à 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 l'attachement du message.

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