Method: media.upload

מעלה קובץ מצורף. דוגמה לכך נמצאת בקטע העלאת מדיה כקובץ מצורף. נדרש אימות של המשתמש.

אפשר להעלות קבצים מצורפים בגודל של עד 200MB. אין תמיכה בסוגים מסוימים של קבצים. כאן תוכלו לקרוא על סוגי הקבצים שנחסמים על ידי Google Chat.

בקשת HTTP

  • העלאת URI, לבקשות להעלאת מדיה:
    POST https://chat.googleapis.com/upload/v1/{parent=spaces/*}/attachments:upload
  • URI של מטא-נתונים, לבקשות למטא-נתונים בלבד:
    POST https://chat.googleapis.com/v1/{parent=spaces/*}/attachments:upload

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. שם המשאב של המרחב המשותף ב-Chat שאליו הקובץ המצורף הועלה. פורמט 'מרחבים/{space}'.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "filename": string
}
שדות
filename

string

חובה. שם הקובץ המצורף, כולל סיומת הקובץ.

גוף התשובה

תשובה לגבי העלאת קובץ מצורף.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "attachmentDataRef": {
    object (AttachmentDataRef)
  }
}
שדות
attachmentDataRef

object (AttachmentDataRef)

הפניה לקובץ המצורף שהועלה.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages.create
  • https://www.googleapis.com/auth/chat.messages

למידע נוסף, עיינו במדריך ההרשאות.