Recuperare i metadati relativi a un allegato a un messaggio

Questa guida spiega come utilizzare il metodo get() nella risorsa Attachment dell' API Google Chat per recuperare i metadati di un allegato del messaggio. La risposta è un'istanza della risorsa Attachment.

Quando l'utente invia un messaggio alla tua app, Google Chat invia un MESSAGE evento di interazione. L'evento di interazione ricevuto dalla tua app include un corpo della richiesta, ovvero il payload JSON che rappresenta l'evento di interazione, inclusi eventuali allegati. I dati nell'allegato sono diversi a seconda che si tratti di contenuti caricati (un file locale) o di un file archiviato su Drive. La risorsa Media rappresenta un file caricato su Google Chat, ad esempio immagini, video e documenti. La risorsa Attachment rappresenta un'istanza di un elemento multimediale, ovvero un file, allegato a un messaggio. La risorsa Attachment include i metadati dell'allegato, ad esempio la posizione in cui è salvato.

Prerequisiti

Node.js

Ricevere un allegato di un messaggio

Per ottenere in modo asincrono i metadati di un allegato di un messaggio in Google Chat, passa quanto segue nella richiesta:

  • Specifica l'ambito dell'autorizzazione chat.bot.
  • Chiama il metodo GetAttachment(), trasmettendo il name dell'allegato del messaggio.

Ecco come ottenere i metadati di un allegato di un messaggio:

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);

Per eseguire questo esempio, sostituisci spaces/SPACE_NAME/messages/ MESSAGE_NAME/attachments/ATTACHMENT_NAME con il nome dell'allegato del messaggio.

L'API Chat restituisce un'istanza di Attachment che descrive in dettaglio i metadati relativi all'allegato del messaggio specificato.