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 correspond à 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

Récupérer une pièce jointe

Pour obtenir de manière asynchrone des métadonnées sur une pièce jointe 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 paramètre name de la pièce jointe au 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 la pièce jointe au 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.