Carga de archivos multimedia

La función de carga de contenido multimedia te permite almacenar datos que puedes usar en Display & Video 360. Entre los tipos de datos que uno podría querer subir, se incluyen fotos, videos, archivos ZIP, etcétera.

Opciones de carga

La API de Display & Video 360 te permite subir ciertos tipos de datos binarios o multimedia. Las características de los datos que puedes subir se detallan en la guía para desarrolladores de cualquier tarea que requiera una carga de contenido multimedia:

• Tamaño máximo de carga de archivos: La cantidad máxima de datos que puedes almacenar con este método
• Tipos de MIME multimedia aceptados: Los tipos de datos binarios que puedes almacenar con este método

Puedes realizar solicitudes de carga de cualquiera de las siguientes formas. Especifica el método que usas con el parámetro uploadType.

• Carga simple: uploadType=media. Una transferencia rápida para archivos de aproximadamente 5 MB o menos.
• Carga multiparte: uploadType=multipart. Una transferencia rápida de archivos y metadatos relevantes. Transfiere el archivo y los metadatos en una sola solicitud.

Cuando subes contenido multimedia, usas un URI /upload. Cuando transfieras los datos del contenido multimedia, usa este URI

Ejemplo:

  POST /upload/media/resource-name

Carga simple

Una solicitud de carga simple es el método más sencillo para subir un archivo. Esta es una buena opción en los siguientes casos:

• El archivo es lo suficientemente pequeño como para volver a subirlo, si es necesario.
• Si no hay metadatos para enviar Esto podría ocurrir si los metadatos no son necesarios o se incluyen en otro lugar de la solicitud.

Para usar una carga simple, realiza una solicitud POST o PUT al URI /upload del método y agrega el parámetro de consulta uploadType=media. Por ejemplo:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

Entre los encabezados HTTP que se deben usar cuando se realiza una carga simple, se incluyen los siguientes:

• Content-Type. Se establece como uno de los tipos de datos multimedia aceptados del método.
• Content-Length. Se establece como la cantidad de bytes que estás subiendo. No es obligatorio si usas la codificación de transferencia fragmentada.

Carga multiparte

Si tienes metadatos para enviar con los datos que vas a subir, puedes realizar una solicitud multipart/related. Esta es una buena opción si los datos que vas a enviar son lo suficientemente pequeños como para volver a subirlos, si es necesario.

Para usar la carga multiparte, realiza una solicitud POST o PUT al URI /upload del método y agrega el parámetro de consulta uploadType=multipart. Por ejemplo:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

Entre los encabezados HTTP de nivel superior que se deben usar cuando se realiza una solicitud de carga multiparte, se incluyen los siguientes:

• Content-Type. Se establece en multipart/related y se incluye la cadena de límite que se usa para identificar las partes de la solicitud.
• Content-Length. Configurado como la cantidad total de bytes en el cuerpo de la solicitud. La parte de contenido multimedia de la solicitud debe ser menor que el tamaño de archivo máximo especificado para este método.

El cuerpo de la solicitud tiene el formato de un tipo de contenido multipart/related [RFC2387] y contiene exactamente dos partes. Las partes se identifican con una cadena de límite, y la última cadena va seguida de dos guiones.

Cada parte de la solicitud multiparte necesita un encabezado Content-Type adicional:

1. Parte de metadatos: Debe ir primero, y Content-Type debe coincidir con uno de los formatos de metadatos aceptados.
2. Parte de contenido multimedia: Debe ir en segundo lugar, y Content-Type debe coincidir con uno de los tipos de MIME multimedia aceptados del método.

Ejemplos

Subes medios con la API de Display & Video 360 para realizar diversas tareas. En esta sección, se proporcionan ejemplos como solicitudes de curl.

Sube un recurso de creatividad

Sigue estos pasos para subir un recurso de creatividad:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

Consulta la guía Sube recursos de creatividad para obtener más detalles y ejemplos de código.

Sube el archivo de secuencia de comandos de ofertas personalizadas

Sigue estos pasos para subir un archivo de secuencia de comandos:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

Consulta la guía de secuencia de comandos de carga para obtener más detalles y ejemplos de código.