Caricamento di contenuti multimediali

La funzionalità di caricamento dei contenuti multimediali ti consente di archiviare i dati che puoi utilizzare in Display & Video 360. I tipi di dati che si potrebbero voler caricare includono foto, video, file ZIP e così via.

Opzioni di caricamento

L'API Display & Video 360 ti consente di caricare determinati tipi di dati binari o contenuti multimediali. Le caratteristiche dei dati che puoi caricare sono descritte in dettaglio nella guida per gli sviluppatori per qualsiasi attività che richieda il caricamento di contenuti multimediali:

• Dimensione massima del file di caricamento: la quantità massima di dati che puoi archiviare con questo metodo.
• Tipi MIME di contenuti multimediali accettati: i tipi di dati binari che puoi archiviare utilizzando questo metodo.

Puoi effettuare richieste di caricamento in uno dei seguenti modi. Specifica il metodo che utilizzi con il parametro uploadType.

• Caricamento semplice: uploadType=media. Un trasferimento rapido per file di circa 5 MB o meno.
• Caricamento in più parti: uploadType=multipart. Un trasferimento rapido di file e metadati pertinenti. Trasferisce il file e i metadati in un'unica richiesta.

Quando carichi contenuti multimediali, utilizzi un URI /upload. Utilizza questo URI durante il trasferimento dei dati multimediali.

Esempio:

  POST /upload/media/resource-name

Caricamento semplice

Una semplice richiesta di caricamento è il metodo più semplice per caricare un file. Questa è una buona scelta quando:

• Il file è abbastanza piccolo da essere caricato di nuovo, se necessario.
• Non ci sono metadati da inviare. Ciò potrebbe essere vero se i metadati non sono necessari o sono inclusi altrove nella richiesta.

Per utilizzare il caricamento semplice, invia una richiesta POST o PUT all'URI /upload del metodo e aggiungi il parametro di query uploadType=media. Ad esempio:

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

Le intestazioni HTTP da utilizzare per un caricamento semplice includono:

• Content-Type. Imposta uno dei tipi di dati multimediali accettati dal metodo.
• Content-Length. Imposta il numero di byte che stai caricando. Non richiesto se utilizzi la codifica di trasferimento chunked.

Caricamento multiparte

Se hai metadati da inviare con i dati da caricare, puoi effettuare una richiesta multipart/related. Si tratta di una buona scelta se i dati che invii sono abbastanza piccoli da essere caricati di nuovo, se necessario.

Per utilizzare il caricamento in più parti, invia una richiesta POST o PUT all'URI /upload del metodo e aggiungi il parametro di query uploadType=multipart. Ad esempio:

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

Le intestazioni HTTP di primo livello da utilizzare quando si effettua una richiesta di caricamento in più parti includono:

• Content-Type. Imposta su multipart/related e includi la stringa di delimitazione che utilizzi per identificare le parti della richiesta.
• Content-Length. Imposta il numero totale di byte nel corpo della richiesta. La parte multimediale della richiesta deve essere inferiore alla dimensione massima del file specificata per questo metodo.

Il corpo della richiesta è formattato come tipo di contenuti multipart/related [RFC2387] e contiene esattamente due parti. Le parti sono identificate da una stringa di delimitazione e la stringa di delimitazione finale è seguita da due trattini.

Ogni parte della richiesta in più parti richiede un'intestazione Content-Type aggiuntiva:

1. Sezione dei metadati: deve essere la prima e Content-Typedeve corrispondere a uno dei formati di metadati accettati.
2. Parte multimediale: deve essere la seconda e Content-Type deve corrispondere a uno dei tipi MIME multimediali accettati dal metodo.

Esempi

Carichi i contenuti multimediali utilizzando l'API Display & Video 360 per svolgere varie attività. Questa sezione fornisce esempi come richieste curl.

Caricare l'asset della creatività

Ecco come caricare un asset della creatività:

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"

Per ulteriori dettagli ed esempi di codice, consulta la guida Caricare asset delle creatività.

Carica il file dello script di offerte personalizzate

Ecco come caricare un file di 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

Per ulteriori dettagli ed esempi di codice, consulta la guida Script di caricamento.