Получить метаданные о вложении сообщения

В этом руководстве объясняется, как использовать метод get() ресурса Attachment API Google Chat для получения метаданных о вложенном сообщении. В ответе будет получен экземпляр ресурса Attachment .

Когда пользователь отправляет сообщение в ваше приложение, Google Chat отправляет событие взаимодействия MESSAGE . Событие взаимодействия, полученное вашим приложением, включает тело запроса, которое представляет собой полезную нагрузку JSON, отражающую событие взаимодействия, включая любые вложения. Данные во вложении различаются в зависимости от того, является ли вложение загруженным контентом (локальным файлом) или файлом, хранящимся на Google Диске. Ресурс Media представляет собой файл, загруженный в Google Chat, например, изображения, видео или документы. Ресурс Attachment представляет собой экземпляр медиафайла, прикрепленного к сообщению. Ресурс Attachment включает метаданные о вложении, например, место его сохранения.

Предварительные требования

Node.js

• Корпоративный аккаунт Google Workspace с доступом к Google Chat .

• Настройте свою среду:
  • Создайте проект в Google Cloud .
  • Настройте экран согласия OAuth .
  • Включите и настройте API Google Chat, указав имя, значок и описание для вашего приложения чата.
  • Установите библиотеку Node.js Cloud Client .
  • Создайте учетные данные сервисной учетной записи . Чтобы запустить пример из этого руководства, сохраните учетные данные в виде JSON-файла с именем credentials.json в локальной директории.
• Выберите область авторизации , поддерживающую аутентификацию приложений.

Примеры кода на этой странице используют интерфейс gRPC API с клиентскими библиотеками Google Cloud. В качестве альтернативы можно использовать интерфейс REST API. Дополнительную информацию об интерфейсах gRPC и REST см. в разделе «Обзор Google Chat API» .

Прикрепить сообщение

Для асинхронного получения метаданных о вложенном сообщении в Google Chat передайте в запросе следующее:

• Укажите область авторизации chat.bot .
• Вызовите метод GetAttachment() , передав ему name вложения сообщения.

Вот как получить метаданные о вложенном сообщении:

Node.js

chat/client-libraries/cloud/get-attachment-app-cred.js

Посмотреть на GitHub

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

Для запуска этого примера замените spaces/ SPACE_NAME /messages/ MESSAGE_NAME /attachments/ ATTACHMENT_NAME на имя вложения сообщения.

API чата возвращает экземпляр Attachment , содержащий подробную информацию о метаданных указанного вложения сообщения.

Связанные темы

• Загрузите медиафайл в качестве вложения.
• Скачать медиафайл в виде вложения.