new_releases Bản cập nhật: Kiểm tra
ghi chú phát hành để biết thông tin về các tính năng mới và bản cập nhật sản phẩm.
Method: files.create
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tải tệp lên để sử dụng trong tin nhắn đa phương tiện hoặc thẻ đa dạng thức.
Tác nhân cung cấp URL hoặc tệp nhị phân của tệp và (không bắt buộc) URL của tệp hình thu nhỏ tương ứng.
Quan trọng: Để đảm bảo quyền riêng tư và sự an toàn của người dùng, nền tảng RBM sẽ tải xuống và xử lý các tệp phương tiện và tệp PDF từ URL được cung cấp trước khi phân phối các tệp đó cho người dùng. Điều này ngăn việc theo dõi đại lý theo URL duy nhất. Do đó, đừng gửi quá nhiều URL duy nhất. Nền tảng RBM không hỗ trợ việc này, cho dù các URL trỏ đến cùng một tệp hay các tệp khác nhau. Sử dụng cùng một URL cho các tệp giống hệt nhau.
Nền tảng RBM lưu tệp vào bộ nhớ đệm trong 60 ngày và trả về một tên duy nhất mà bạn có thể dùng để xác định tệp khi gửi thông báo của tác nhân.
Để tải tệp nhị phân lên, hãy tạo một yêu cầu HTTP POST đến URI Tải lên, bỏ qua trường fileUrl khỏi nội dung yêu cầu JSON và chỉ định tệp nhị phân làm nội dung yêu cầu POST. Ví dụ: sử dụng cờ cURL --upload-file với đường dẫn tệp đủ điều kiện của tệp nhị phân.
Yêu cầu HTTP
- URI tải lên, dành cho các yêu cầu tải nội dung nghe nhìn lên:
POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
- URI siêu dữ liệu, dành cho các yêu cầu chỉ siêu dữ liệu:
POST https://rcsbusinessmessaging.googleapis.com/v1/files
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"fileUrl": string,
"thumbnailUrl": string,
"agentId": string
} |
| Trường |
fileUrl |
string
Không bắt buộc. URL công khai của tệp. Nền tảng RBM xác định loại MIME của tệp từ trường content-type trong tiêu đề HTTP khi tìm nạp tệp. RBM hỗ trợ hình ảnh, âm thanh, video và tệp PDF. Các loại nội dung hình ảnh được hỗ trợ: image/jpeg, image/jpg, image/gif, image/png. Các loại nội dung âm thanh được hỗ trợ: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg. Các loại nội dung video được hỗ trợ: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm. Các loại nội dung PDF được hỗ trợ: application/pdf. Lưu ý: URL tệp có thể có 1 lệnh chuyển hướng. URL của tệp được chuyển hướng phải có thể truy cập công khai. Không hỗ trợ chuyển hướng cho URL tệp trong CreateAgentMessageRequest.
|
thumbnailUrl |
string
Không bắt buộc. URL công khai của hình thu nhỏ tương ứng với tệp. Nếu bạn không đặt trường này, thì nền tảng RBM sẽ tự động tạo hình thu nhỏ từ tệp. Nền tảng RBM xác định loại MIME của tệp từ trường content-type trong tiêu đề HTTP khi tìm nạp tệp. Các loại nội dung hình ảnh được hỗ trợ: image/jpeg, image/jpg, image/gif, image/png.
|
agentId |
string
Bắt buộc. Giá trị nhận dạng duy nhất của tác nhân.
|
Nội dung phản hồi
Tài nguyên tệp có tên riêng biệt mà tác nhân có thể sử dụng để xác định tệp khi gửi thông báo.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"name": string
} |
| Trường |
name |
string
Tên riêng biệt do máy chủ chỉ định của tài nguyên tệp mà tác nhân có thể sử dụng để xác định tệp khi gửi thông báo. Định dạng là "files/{uid}", trong đó {uid} là mã nhận dạng duy nhất.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/rcsbusinessmessaging
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\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)."]]
