new_releases التعديلات: يمكنك الاطّلاع على
ملاحظات الإصدار للتعرّف على الميزات الجديدة وتحديثات المنتجات.
Method: files.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لتحميل ملف لاستخدامه في الوسائط أو رسائل البطاقات التفاعلية.
يقدّم موظّف الدّعم عنوان URL أو الملف الثنائي للملف وعنوان URL لملف الصورة المصغّرة المقابل (اختياريًا).
ملاحظة مهمة: للحفاظ على خصوصية المستخدم وأمانه، تنزِّل منصة RBM الوسائط وملفات PDF من عناوين URL المقدَّمة وتعالجها قبل تسليمها إلى المستخدم. يمنع ذلك تتبُّع موظّف الدّعم من خلال عناوين URL فريدة. لذلك، لا ترسِل عددًا كبيرًا من عناوين URL الفريدة. لا تتيح منصة RBM ذلك، سواء كانت عناوين URL تشير إلى الملفات نفسها أو مختلفة. استخدِم عنوان URL نفسه للملفات المتطابقة.
تخزِّن منصة RBM الملف في ذاكرة التخزين المؤقت لمدة 60 يومًا وتُعرِض اسمًا فريدًا يمكنك استخدامه لتحديد الملف عند إرسال رسائل موظّفي الدعم.
لتحميل ملف ثنائي، يمكنك إرسال طلب POST عبر بروتوكول HTTP إلى معرّف الموارد المنتظم (URI) لتحميل الملف، مع حذف الحقل fileUrl من محتوى طلب JSON، وتحديد الملف الثنائي كمحتوى طلب POST. على سبيل المثال، استخدِم علامة --upload-file cURL مع مسار الملف المؤهَّل بالكامل للملف الثنائي.
طلب HTTP
- عنوان URL لتحميل طلبات تحميل الوسائط:
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 للملف المتاح للجميع تحدِّد منصة RBM نوع 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 متاح للجميع للصورة المصغّرة المقابلة للملف في حال عدم ضبط هذا الحقل، تنشئ منصة RBM تلقائيًا صورة مصغّرة من الملف. تحدِّد منصة RBM نوع 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.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis process allows agents to upload files, including images, audio, video, and PDFs, for use in media or rich card messages, either by providing a public URL or the file's binary data.\u003c/p\u003e\n"],["\u003cp\u003eThe RBM platform handles file privacy and security by downloading and processing media files from provided URLs, preventing agent tracking via unique URLs, and caches the file for 60 days.\u003c/p\u003e\n"],["\u003cp\u003eThe file upload requires an HTTP POST request to either the upload URI \u003ccode\u003ehttps://rcsbusinessmessaging.googleapis.com/upload/v1/files\u003c/code\u003e or the metadata-only URI \u003ccode\u003ehttps://rcsbusinessmessaging.googleapis.com/v1/files\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe agent can provide a public \u003ccode\u003efileUrl\u003c/code\u003e, \u003ccode\u003ethumbnailUrl\u003c/code\u003e, and must include the \u003ccode\u003eagentId\u003c/code\u003e within the request body to upload files.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful upload, the RBM platform returns a unique file name (\u003ccode\u003ename\u003c/code\u003e) that agents can use to reference the file in subsequent messages.\u003c/p\u003e\n"]]],[],null,["# Method: files.create\n\nUploads a file for use in media or rich card messages.\n\nThe agent provides the URL or binary of the file and (optionally) the URL of the corresponding thumbnail file.\n\nImportant: For user privacy and security, the RBM platform downloads and processes media and PDF files from the provided URLs before delivering them to the user. This prevents agent tracking by unique URLs. Therefore, do not submit a high volume of unique URLs. The RBM platform does not support this, whether the URLs point to the same or different files. Use the same URL for identical files.\n\nThe RBM platform caches the file for 60 days and returns a unique name that you can use to identify the file when sending agent messages.\n\nTo upload a file binary, make an HTTP POST request to the Upload URI, omit the `fileUrl` field from the JSON request body, and specify the binary as the POST request body. For example, use the `--upload-file` cURL flag with the fully qualified file path of the binary file.\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files`\n- Metadata URI, for metadata-only requests: \n `POST https://rcsbusinessmessaging.googleapis.com/v1/files`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------|\n| ``` { \"fileUrl\": string, \"thumbnailUrl\": string, \"agentId\": string } ``` |\n\n| Fields ||\n|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileUrl` | `string` Optional. Publicly available URL of the file. The RBM platform determines the MIME type of the file from the content-type field in the HTTP headers when fetching the file. RBM supports image, audio, video, and pdf. Supported image content types: image/jpeg, image/jpg, image/gif, image/png. Supported audio content types: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg. Supported video content types: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm. Supported pdf content types: application/pdf. Note: file URL can have 1 redirect. Redirected file URLs must be publicly accessible. Redirects are not supported for file URLs in CreateAgentMessageRequest. |\n| `thumbnailUrl` | `string` Optional. Publicly available URL of the thumbnail corresponding to the file. If this field is not set, then the RBM platform automatically generates a thumbnail from the file. The RBM platform determines the MIME type of the file from the content-type field in the HTTP headers when fetching the file. Supported image content types: image/jpeg, image/jpg, image/gif, image/png. |\n| `agentId` | `string` Required. The agent's unique identifier. |\n\n### Response body\n\nA file resource with a unique name that an agent can use to identify the file when sending messages.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------|\n| ``` { \"name\": string } ``` |\n\n| Fields ||\n|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Server-assigned unique name of the file resource, which an agent can use to identify the file when sending messages. The format is \"files/{uid}\", where {uid} is a unique ID. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/rcsbusinessmessaging`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
