new_releases Update: Periksa
catatan rilis untuk mengetahui fitur baru dan update produk.
Method: files.create
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mengupload file untuk digunakan dalam pesan media atau kartu informasi.
Agen memberikan URL atau biner file dan (opsional) URL file thumbnail yang sesuai.
Penting: Untuk privasi dan keamanan pengguna, platform RBM mendownload dan memproses file media dan PDF dari URL yang diberikan sebelum mengirimkannya kepada pengguna. Hal ini mencegah pelacakan agen berdasarkan URL unik. Oleh karena itu, jangan mengirimkan URL unik dalam jumlah besar. Platform RBM tidak mendukung hal ini, baik URL mengarah ke file yang sama maupun berbeda. Gunakan URL yang sama untuk file yang identik.
Platform RBM meng-cache file selama 60 hari dan menampilkan nama unik yang dapat Anda gunakan untuk mengidentifikasi file saat mengirim pesan agen.
Untuk mengupload file biner, buat permintaan POST HTTP ke URI Upload, hapus kolom fileUrl dari isi permintaan JSON, dan tentukan biner sebagai isi permintaan POST. Misalnya, gunakan flag cURL --upload-file dengan jalur file yang sepenuhnya memenuhi syarat dari file biner.
Permintaan HTTP
- URI upload, untuk permintaan upload media:
POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
- URI metadata, khusus untuk permintaan metadata:
POST https://rcsbusinessmessaging.googleapis.com/v1/files
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
| Representasi JSON |
{
"fileUrl": string,
"thumbnailUrl": string,
"agentId": string
} |
| Kolom |
fileUrl |
string
Opsional. URL file yang tersedia secara publik. Platform RBM menentukan jenis MIME file dari kolom content-type di header HTTP saat mengambil file. RBM mendukung gambar, audio, video, dan pdf. Jenis konten gambar yang didukung: image/jpeg, image/jpg, image/gif, image/png. Jenis konten audio yang didukung: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg. Jenis konten video yang didukung: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm. Jenis konten PDF yang didukung: application/pdf. Catatan: URL file dapat memiliki 1 pengalihan. URL file yang dialihkan harus dapat diakses secara publik. Pengalihan tidak didukung untuk URL file di CreateAgentMessageRequest.
|
thumbnailUrl |
string
Opsional. URL thumbnail yang tersedia secara publik dan sesuai dengan file. Jika kolom ini tidak ditetapkan, platform RBM akan otomatis membuat thumbnail dari file. Platform RBM menentukan jenis MIME file dari kolom content-type di header HTTP saat mengambil file. Jenis konten gambar yang didukung: image/jpeg, image/jpg, image/gif, image/png.
|
agentId |
string
Wajib. ID unik agen.
|
Isi respons
Resource file dengan nama unik yang dapat digunakan agen untuk mengidentifikasi file saat mengirim pesan.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"name": string
} |
| Kolom |
name |
string
Nama unik resource file yang ditetapkan server, yang dapat digunakan agen untuk mengidentifikasi file saat mengirim pesan. Formatnya adalah "files/{uid}", dengan {uid} adalah ID unik.
|
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/rcsbusinessmessaging
Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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)."]]
