Method: files.create

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

يقدّم الوكيل عنوان URL أو البيانات الثنائية للملف، وعنوان URL لملف الصورة المصغّرة المقابل (اختياريًا).

ملاحظة مهمة: للحفاظ على خصوصية المستخدم وأمانه، تنزّل منصة "خدمات RCS للأنشطة التجارية" ملفات الوسائط وملفات PDF وتعالجها من عناوين URL المقدَّمة قبل إرسالها إلى المستخدم. يؤدي ذلك إلى منع تتبُّع الوكيل من خلال عناوين URL فريدة، لذا لا ترسِل عددًا كبيرًا من عناوين URL الفريدة، لأنّ منصة "RCS للأعمال" لا تتيح ذلك، سواء كانت عناوين URL تشير إلى الملف نفسه أو إلى ملفات مختلفة. استخدِم عنوان URL نفسه للملفات المتطابقة.

تخزّن منصة "RCS للمؤسسات" الملف مؤقتًا لمدة 60 يومًا وتعرض اسمًا فريدًا يمكنك استخدامه لتحديد الملف عند إرسال رسائل الوكيل.

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

طلب HTTP

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

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

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

string

اختيارية: عنوان URL للملف متاح للجميع. تحدّد منصة "خدمات الاتصالات التفاعلية للأنشطة التجارية" نوع MIME للملف من حقل نوع المحتوى في عناوين HTTP عند جلب الملف. تتوافق خدمة "خدمات الاتصالات التفاعلية للأنشطة التجارية" مع الصور والملفات الصوتية والفيديوهات وملفات PDF.

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

أنواع المحتوى الصوتي المتوافقة: audio/aac وaudio/mp3 وaudio/mpeg وaudio/mpg وaudio/mp4 وaudio/mp4-latm وaudio/3gpp وapplication/ogg وaudio/ogg

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

أنواع محتوى PDF المتوافقة: application/pdf

ملاحظة: يمكن أن يتضمّن عنوان URL الخاص بملف عملية إعادة توجيه واحدة. يجب أن تتوفّر للجميع إمكانية الوصول إلى عناوين URL الخاصة بالملفات التي تمّت إعادة توجيهها. لا يمكن استخدام عمليات إعادة التوجيه لعناوين URL الخاصة بالملفات في CreateAgentMessageRequest.
thumbnailUrl

string

اختيارية: تمثّل هذه السمة عنوان URL متاحًا للجميع للصورة المصغّرة التي تتوافق مع الملف. في حال عدم ضبط هذا الحقل، ستنشئ منصة "خدمات الاتصالات التفاعلية للأنشطة التجارية" تلقائيًا صورة مصغّرة من الملف. تحدّد منصة "خدمات الاتصالات التفاعلية للأنشطة التجارية" نوع MIME للملف من حقل نوع المحتوى في عناوين HTTP عند جلب الملف.

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

string

الحقل مطلوب. المعرّف الفريد للوكيل.

نص الاستجابة

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

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

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

string

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

نطاقات الأذونات

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.