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 os anexos. Os dados no anexo serão diferentes se o anexo for um conteúdo enviado por upload (um arquivo local) ou se for um arquivo armazenado no Drive. O recurso Media 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 o local em que ele é salvo.

Pré-requisitos

Node.js

Receber um anexo de mensagem

Para receber de forma assíncrona os 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(), transmitindo o name do anexo da mensagem.

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

main().catch(console.error);

Para executar esta amostra, 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.