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

Ce guide explique comment utiliser la get() méthode 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 Attachment ressource.

Lorsque l'utilisateur envoie un message à votre application, Google Chat distribue un MESSAGE événement d'interaction. 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 varient selon qu'il s'agit d'un contenu importé (un fichier local) ou d'un fichier stocké sur Drive. La ressource Media `Media` représente un fichier importé dans Google Chat, comme des images, des vidéos et des documents. La Attachment ressource représente une instance de média (un fichier) jointe à un message. La ressource Attachment inclut les métadonnées de la pièce jointe, par exemple 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 d'autorisation chat.bot.
  • Appelez la GetAttachment() méthode, 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);
}

await main();

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