Method: files.create

تحميل ملف لاستخدامه في الوسائط أو رسائل البطاقات التفاعلية

يقدّم الوكيل عنوان URL أو البرنامج الثنائي للملف و (اختياريًا) عنوان URL لملف الصورة المصغّرة المقابل. تخزِّن منصة RBM الملف في ذاكرة التخزين المؤقت لمدة 30 يومًا وتعرض اسمًا فريدًا يمكنك استخدامه لتحديد الملف عند إرسال رسائل الوكلاء.

لتحميل ملف ثنائي، يمكنك تقديم طلب HTTP POST إلى معرّف الموارد المنتظم (URI) للتحميل، وحذف الحقل fileUrl من نص طلب JSON، وتحديد البرنامج الثنائي كنص لطلب POST. على سبيل المثال، استخدِم علامة cURL --upload-file مع مسار الملف المؤهّل بالكامل للملف الثنائي.

طلب HTTP

  • معرّف الموارد المنتظم (URI) للتحميل، لطلبات تحميل الوسائط:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • معرّف الموارد المنتظم (URI) للبيانات الوصفية، لطلبات البيانات الوصفية فقط:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "contentDescription": string,
  "agentId": string
}
الحقول
fileUrl

string

اختياريّ. هو عنوان URL للملف المتاح للجميع. يحدِّد النظام الأساسي RBM نوع MIME للملف من حقل نوع المحتوى في عناوين HTTP عند جلب الملف.

أنواع محتوى الصور المتوافقة: image/jpeg وimage/jpg وimage/gif وimage/png.

أنواع محتوى الفيديو المتوافقة: video/h263، وvideo/m4v، وvideo/mp4، وvideo/mpeg، وvideo/mpeg4، وvideo/webm.
thumbnailUrl

string

اختياريّ. تشير هذه السمة إلى عنوان URL المتوفّر بشكل علني للصورة المصغّرة المقابلة للملف. في حال عدم ضبط هذا الحقل، سينشئ النظام الأساسي "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" صورة مصغّرة تلقائيًا من الملف. يحدِّد النظام الأساسي RBM نوع MIME للملف من حقل نوع المحتوى في عناوين HTTP عند جلب الملف.

أنواع محتوى الصور المتوافقة: image/jpeg وimage/jpg وimage/gif وimage/png.
contentDescription

string

اختياريّ. الوصف النصي لمحتوى الملف. تستخدم برامج قراءة الشاشة هذا الوصف لمساعدة المستخدمين من ذوي الاحتياجات الخاصة على فهم محتوى الملف.
agentId

string

مطلوبة. المعرِّف الفريد للوكيل

نص الاستجابة

مورد ملف باسم فريد يمكن للوكيل استخدامه لتحديد الملف عند إرسال الرسائل.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "name": string
}
الحقول
name

string

اسم فريد يعينه الخادم لمورد الملف، والذي يمكن أن يستخدمه الوكيل لتحديد الملف عند إرسال الرسائل. التنسيق هو "files/{uid}"، حيث تكون {uid} معرّفًا فريدًا.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.