Method: files.create

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 forma opcional, la URL del archivo de miniatura correspondiente.

Importante: Para garantizar la privacidad y la seguridad de los usuarios, la plataforma de RCS para empresas descarga y procesa los 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 una gran cantidad de URLs únicas. La plataforma de RCS para empresas no admite esta acción, ya sea que las URLs apunten a los mismos archivos o a archivos diferentes. Usa la misma URL para los archivos idénticos.

La plataforma de RCS para empresas almacena en caché el archivo durante 60 días y devuelve un nombre único que puedes usar para identificar el archivo cuando envíes mensajes del agente.

Para subir un archivo binario, realiza una solicitud HTTP POST al URI de carga, omite el campo fileUrl del cuerpo de la solicitud JSON y especifica el archivo 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 disponible públicamente del archivo. La plataforma de RCS para empresas determina el tipo de MIME del archivo a partir del campo content-type en los encabezados HTTP cuando recupera el archivo. RCS para empresas admite imágenes, audio, video y 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, audio/ogg.

Tipos de contenido de video admitidos: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Tipos de contenido en PDF admitidos: application/pdf.

Nota: Una URL de archivo puede tener un redireccionamiento. Las URLs de archivos redireccionadas deben ser de acceso público. Los redireccionamientos no se admiten para las URLs de archivos en CreateAgentMessageRequest.
thumbnailUrl

string

Opcional. Es la URL disponible públicamente de la miniatura correspondiente al archivo. Si no se configura este campo, la plataforma de RCS para empresas generará automáticamente una miniatura a partir del archivo. La plataforma de RCS para empresas determina el tipo de MIME del archivo a partir del campo content-type 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

Nombre único asignado por el servidor para el recurso de archivo que los agentes pueden usar para identificar el archivo cuando envían mensajes. El formato es "files/{uid}", en el que {uid} es un ID único.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Para obtener más información, consulta OAuth 2.0 Overview.