קבלת מטא-נתונים על קובץ מצורף להודעה

במדריך הזה מוסבר איך להשתמש בשיטה get() במשאב Attachment של Google Chat API כדי לקבל מטא-נתונים על קובץ מצורף להודעה. התשובה היא מופע של Attachment המשאב.

כשהמשתמש שולח הודעה לאפליקציה, מערכת Google Chat שולחת אירוע אינטראקציה MESSAGE. אירוע האינטראקציה שמתקבל באפליקציה כולל גוף בקשה, שהוא מטען ייעודי (payload) בפורמט JSON שמייצג את אירוע האינטראקציה, כולל קבצים מצורפים. הנתונים בקובץ המצורף שונים בהתאם לסוג הקובץ המצורף: תוכן שהועלה (קובץ מקומי) או קובץ ששמור ב-Drive. המשאב Media מייצג קובץ שהועלה ל-Google Chat, כמו תמונות, סרטונים ומסמכים. המשאב Attachment מייצג מכונה של מדיה – קובץ – שמצורפת להודעה. Attachmentהמשאב כולל את המטא-נתונים של הקובץ המצורף, כמו המיקום שבו הוא נשמר.

דרישות מוקדמות

Node.js

קבלת קובץ מצורף להודעה

כדי לקבל באופן אסינכרוני מטא נתונים על קובץ מצורף להודעה ב-Google Chat, מעבירים את הפרטים הבאים בבקשה:

  • מציינים את chat.bot היקף ההרשאה.
  • מפעילים את ה-method‏ GetAttachment() ומעבירים את name של הקובץ המצורף להודעה.

כך מקבלים מטא-נתונים על קובץ מצורף להודעה:

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

כדי להריץ את הדוגמה הזו, מחליפים את spaces/SPACE_NAME/messages/ MESSAGE_NAME/attachments/ATTACHMENT_NAME בשם הקובץ המצורף להודעה.

ה-Chat API מחזיר מופע של Attachment שמפרט את המטא-נתונים לגבי הקובץ המצורף להודעה שצוינה.