Method: media.upload

تحميل مرفق على سبيل المثال، اطّلِع على تحميل الوسائط كمرفق ملف.

تتطلّب مصادقة المستخدم باستخدام أحد نطاقات التفويض التالية:

  • https://www.googleapis.com/auth/chat.messages.create
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.import (مساحات وضع الاستيراد فقط)

يمكنك تحميل مرفقات يصل حجمها إلى 200 ميغابايت. بعض أنواع الملفات غير متوافقة. لمعرفة التفاصيل، يُرجى الاطّلاع على أنواع الملفات المحظورة في Google Chat.

طلب HTTP

  • عنوان URL لتحميل طلبات تحميل الوسائط:
    POST https://chat.googleapis.com/upload/v1/{parent=spaces/*}/attachments:upload

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. اسم المورد لمساحة Chat التي تم تحميل المرفق إليها. التنسيق "spaces/{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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.