Receber metadados sobre um anexo de mensagem

Este guia explica como usar o método get() no recurso Attachment da API Google Chat para receber metadados sobre um anexo de mensagem. A resposta é uma instância do recurso Attachment.

Quando o usuário envia uma mensagem para seu app, o Google Chat envia um evento de interação MESSAGE. O evento de interação recebido pelo app inclui um corpo de solicitação, que é o payload JSON que representa o evento de interação, incluindo anexos. Os dados no anexo variam dependendo se ele é conteúdo enviado (um arquivo local) ou um arquivo armazenado no Drive. O Media recurso representa um arquivo enviado por upload para o Google Chat, como imagens, vídeos e documentos. O recurso Attachment representa uma instância de mídia (um arquivo) anexada a uma mensagem. O recurso Attachment inclui os metadados sobre o anexo, como onde ele está salvo.

Pré-requisitos

Node.js

Receber um anexo de mensagem

Para receber de forma assíncrona metadados sobre um anexo de mensagem no Google Chat, transmita o seguinte na sua solicitação:

  • Especifique o escopo de autorização chat.bot.
  • Chame o método GetAttachment() e transmita o name do anexo da mensagem.

Veja como receber metadados sobre um anexo de mensagem:

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

Para executar este exemplo, substitua spaces/SPACE_NAME/messages/ MESSAGE_NAME/attachments/ATTACHMENT_NAME pelo nome do anexo da mensagem.

A API Chat retorna uma instância de Attachment que detalha os metadados sobre o anexo de mensagem especificado.