new_releases Actualizaciones: Consulte las
notas de la versión para conocer las funciones nuevas y las actualizaciones de productos.
Method: files.create
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Sube un archivo para usarlo en mensajes de tarjetas enriquecidas o multimedia.
El agente proporciona la URL o el archivo binario del archivo y, de manera opcional, la URL del archivo de miniatura correspondiente.
Importante: Para proteger la privacidad y la seguridad de los usuarios, la plataforma de RBM descarga y procesa archivos multimedia y PDF de las URLs proporcionadas antes de entregarlos al usuario. Esto evita el seguimiento de agentes por URLs únicas. Por lo tanto, no envíes un gran volumen de URLs únicas. La plataforma de RBM no admite esto, ya sea que las URLs apunten al mismo archivo o a archivos diferentes. Usa la misma URL para archivos idénticos.
La plataforma de RBM almacena en caché el archivo durante 60 días y muestra un nombre único que puedes usar para identificarlo cuando envíes mensajes a los agentes.
Para subir un archivo binario, realiza una solicitud POST HTTP al URI de carga, omite el campo fileUrl del cuerpo de la solicitud JSON y especifica el binario como el cuerpo de la solicitud POST. Por ejemplo, usa la marca --upload-file de cURL con la ruta de acceso completamente calificada del archivo binario.
Solicitud HTTP
- URI de carga para las solicitudes de carga de medios:
POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
- URI de metadatos para las solicitudes de metadatos únicamente:
POST https://rcsbusinessmessaging.googleapis.com/v1/files
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Representación JSON |
{
"fileUrl": string,
"thumbnailUrl": string,
"agentId": string
} |
| Campos |
fileUrl |
string
Opcional. Es la URL del archivo disponible de forma pública. La plataforma de RBM determina el tipo de MIME del archivo a partir del campo de tipo de contenido en los encabezados HTTP cuando recupera el archivo. La RBM admite imágenes, audio, video y archivos PDF. Tipos de contenido de imagen admitidos: image/jpeg, image/jpg, image/gif, image/png. Tipos de contenido de audio admitidos: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg y audio/ogg. Tipos de contenido de video admitidos: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm. Tipos de contenido de PDF admitidos: application/pdf. Nota: La URL del archivo puede tener 1 redireccionamiento. Las URLs de los archivos redireccionados deben ser de acceso público. Los redireccionamientos no son compatibles con las URLs de archivos en CreateAgentMessageRequest.
|
thumbnailUrl |
string
Opcional. Es la URL de acceso público de la miniatura correspondiente al archivo. Si no se configura este campo, la plataforma de RBM generará automáticamente una miniatura a partir del archivo. La plataforma de RBM determina el tipo de MIME del archivo a partir del campo de tipo de contenido en los encabezados HTTP cuando recupera el archivo. Tipos de contenido de imagen admitidos: image/jpeg, image/jpg, image/gif, image/png.
|
agentId |
string
Obligatorio. Es el identificador único del agente.
|
Cuerpo de la respuesta
Es un recurso de archivo con un nombre único que un agente puede usar para identificar el archivo cuando envía mensajes.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"name": string
} |
| Campos |
name |
string
Es el nombre único asignado por el servidor al recurso de archivo, que un agente puede usar para identificar el archivo cuando envía mensajes. El formato es "files/{uid}", en el que {uid} es un ID único.
|
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Para obtener más información, consulta OAuth 2.0 Overview.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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)."]]
