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

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

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

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

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

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

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

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

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

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

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

נושאים קשורים

• העלאת מדיה כקובץ מצורף
• הורדת מדיה כקובץ מצורף