new_releases به‌روزرسانی‌ها :
یادداشت‌های انتشار را برای ویژگی‌های جدید و به‌روزرسانی‌های محصول بررسی کنید.
Method: files.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فایلی را برای استفاده در رسانه یا پیام های کارت غنی آپلود می کند.
عامل URL یا باینری فایل و (به صورت اختیاری) URL فایل تصویر کوچک مربوطه را ارائه می کند.
مهم: برای حفظ حریم خصوصی و امنیت کاربر، پلتفرم RBM فایل‌های رسانه‌ای و PDF را قبل از تحویل به کاربر از URLهای ارائه‌شده دانلود و پردازش می‌کند. این از ردیابی عامل توسط URL های منحصر به فرد جلوگیری می کند. بنابراین، حجم بالایی از URL های منحصر به فرد را ارسال نکنید. پلتفرم RBM از این پشتیبانی نمی‌کند، چه URLها به فایل‌های مشابه یا متفاوتی اشاره کنند. از همان URL برای فایل های یکسان استفاده کنید.
پلت فرم RBM فایل را به مدت 60 روز در حافظه پنهان نگه می دارد و یک نام منحصر به فرد را برمی گرداند که می توانید برای شناسایی فایل هنگام ارسال پیام های نماینده استفاده کنید.
برای آپلود یک فایل باینری، یک درخواست HTTP POST به URI آپلود کنید، فیلد fileUrl را از بدنه درخواست JSON حذف کنید و باینری را به عنوان بدنه درخواست POST مشخص کنید. برای مثال، از پرچم --upload-file cURL با مسیر فایل کاملا واجد شرایط فایل باینری استفاده کنید.
درخواست HTTP
- URI آپلود، برای درخواست های آپلود رسانه:
POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files - URI فراداده، برای درخواست‌های فقط فراداده:
POST https://rcsbusinessmessaging.googleapis.com/v1/files
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"fileUrl": string,
"thumbnailUrl": string,
"agentId": string
} |
| فیلدها |
|---|
fileUrl | string اختیاری. URL فایل در دسترس عموم. هنگام واکشی فایل، پلتفرم RBM نوع MIME فایل را از قسمت نوع محتوا در هدرهای HTTP تعیین می کند. RBM از تصویر، صدا، ویدئو و 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 پشتیبانی شده: برنامه/pdf. توجه: آدرس فایل می تواند 1 تغییر مسیر داشته باشد. آدرس‌های اینترنتی فایل تغییر مسیر داده شده باید برای عموم قابل دسترسی باشند. تغییر مسیرها برای 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
