Upload de mídia

Com o recurso de upload de mídia, você pode armazenar dados que podem ser usados no Display & Video 360. É possível fazer upload de fotos, vídeos, arquivos zip e muito mais.

Opções de upload

A API Display & Video 360 permite fazer upload de certos tipos de dados binários ou mídia. As características dos dados que podem ser enviados por upload são detalhadas no guia do desenvolvedor para qualquer tarefa que exija um upload de mídia:

  • Tamanho máximo do arquivo para upload: a quantidade máxima de dados que pode ser armazenada com esse método.
  • Tipos MIME de mídia permitidos: os tipos de dados binários que podem ser armazenados usando esse método.

É possível fazer solicitações de upload de qualquer uma das maneiras a seguir. Especifique o método que você está usando com o parâmetro uploadType.

  • Upload simples: uploadType=media. Uma transferência rápida para arquivos de até 5 MB.
  • Upload de várias partes: uploadType=multipart. Uma transferência rápida para arquivos e metadados relevantes. Transfere o arquivo e os metadados em uma única solicitação.

Ao fazer upload de mídia, você usa um URI /upload. Use esse URI ao transferir os dados de mídia.

Exemplo:

  POST /upload/media/resource-name

Upload simples

Uma solicitação de upload simples é o método mais fácil de enviar um arquivo. Essa é uma boa opção quando:

  • O arquivo é pequeno o suficiente para ser enviado novamente, se necessário.
  • não há metadados para enviar. Isso pode ocorrer se os metadados não forem necessários ou estiverem incluídos em outro lugar na solicitação.

Para usar o upload simples, faça uma solicitação POST ou PUT para o URI /upload do método e adicione o parâmetro de consulta uploadType=media. Exemplo:

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

Os cabeçalhos HTTP a serem usados em um upload simples incluem:

  • Content-Type. Defina como um dos tipos de dados de mídia aceitos pelo método.
  • Content-Length. Defina conforme o número de bytes do upload. Não é exigido em caso de uso da codificação de transferência fragmentada.

Upload de várias partes

Se você tiver metadados para enviar com os dados de upload, poderá fazer uma solicitação multipart/related. Essa é uma boa opção quando os dados que você está enviando são pequenos o bastante para serem enviados novamente, se necessário.

Para usar o upload em várias partes, crie uma solicitação POST ou PUT para o URI /upload do método e adicione o parâmetro de consulta uploadType=multipart. Exemplo:

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

Os cabeçalhos de HTTP de alto nível que podem ser usados na solicitação de upload de várias partes incluem:

  • Content-Type. Defina como multipart/related e inclua a string de limite que você está usando para identificar as partes da solicitação.
  • Content-Length. Defina com o número total de bytes no corpo da solicitação. A parte de mídia da solicitação precisa ser menor que o tamanho máximo de arquivo especificado para este método.

O corpo da solicitação é formatado como um tipo de conteúdo multipart/related [RFC2387] e contém exatamente duas partes. As partes são identificadas por uma string limite, e a última string limite é seguida por dois hifens.

Cada parte da solicitação de várias partes precisa de um cabeçalho Content-Type extra:

  1. Parte de metadados: precisa vir primeiro, e Content-Type precisa corresponder a um dos formatos de metadados aceitos.
  2. Trecho de áudio: precisa vir depois, e Content-Type precisa corresponder a um dos tipos MIME de mídia aceitos pelo método.

Exemplos

Você faz upload de mídia usando a API Display & Video 360 para realizar várias tarefas. Nesta seção, apresentamos exemplos como solicitações curl.

Fazer upload do recurso do criativo

Saiba como fazer upload de um recurso do criativo:

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"

Consulte o guia Fazer upload de recursos de criativos para mais detalhes e exemplos de código.

Fazer upload do arquivo de script de lances personalizados

Saiba como fazer upload de um arquivo de script:

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

Consulte o guia Script de upload para mais detalhes e exemplos de código.