Method: media.upload

يحمّل مرفقًا. على سبيل المثال، يمكنك الاطّلاع على تحميل الوسائط كمرفق ملف. يتطلب المصادقة للمستخدم ونطاق تفويض chat.messages أو chat.messages.create.

يمكنك تحميل مرفقات يصل حجمها إلى 200 ميغابايت. بعض أنواع الملفات غير متوافقة. لمعرفة التفاصيل، يُرجى الاطّلاع على أنواع الملفات المحظورة 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 Transcode.

معلّمات المسار

المعلّمات
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

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