Importation de contenu multimédia

La fonctionnalité d'importation de fichiers multimédias vous permet de stocker des données que vous pouvez utiliser dans Display & Video 360. Vous pouvez ainsi importer des photos, des vidéos, des fichiers zip, etc.

Options d'importation

L'API Display & Video 360 vous permet d'importer certains types de données binaires ou de médias. Les caractéristiques des données que vous pouvez importer sont détaillées dans le guide du développeur pour toute tâche nécessitant l'importation de fichiers multimédias :

• Taille maximale du fichier d'importation : quantité maximale de données que vous pouvez stocker à l'aide de cette méthode.
• Types MIME de médias acceptés : types de données binaires que vous pouvez stocker à l'aide de cette méthode.

Vous pouvez effectuer des requêtes d'importation via l'une des méthodes exposées ci-dessous. Spécifiez la méthode que vous utilisez avec le paramètre uploadType.

• Importation simple : uploadType=media. Transfert rapide pour les fichiers d'environ 5 Mo ou moins.
• Importation en plusieurs parties : uploadType=multipart. Transfert rapide de fichiers et de métadonnées pertinentes. Transfère le fichier et les métadonnées dans une seule requête.

Lorsque vous importez un média, vous utilisez un URI /upload. Utilisez cet URI lors du transfert des données du média.

Exemple :

  POST /upload/media/resource-name

Importation simple

Une requête d'importation simple est la méthode la plus simple pour importer un fichier. Cette option est recommandée dans les cas suivants :

• Le fichier est suffisamment petit pour être réimporté, si nécessaire.
• Aucune métadonnée ne doit être envoyée. Par exemple, les métadonnées ne sont pas nécessaires ou sont incluses ailleurs dans la requête.

Pour utiliser l'importation simple, envoyez une requête POST ou PUT à l'URI /upload de la méthode, puis ajoutez le paramètre de requête uploadType=media. Exemple :

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

Voici les en-têtes HTTP à utiliser lors d'une importation simple :

• Content-Type : spécifiez-y l'un des types de données de médias acceptés par la méthode.
• Content-Length : spécifiez-y le nombre d'octets que vous importez. Cet en-tête n'est pas obligatoire si vous utilisez l'encodage de transfert fragmenté.

Importation en plusieurs parties

Si vous souhaitez envoyer des métadonnées avec les données à importer, vous pouvez effectuer une requête multipart/related. Cette opération est judicieuse si les données que vous envoyez sont suffisamment petites pour pouvoir être importées à nouveau, si nécessaire.

Pour utiliser l'importation en plusieurs parties, envoyez une requête POST ou PUT à l'URI /upload de la méthode, puis ajoutez le paramètre de requête uploadType=multipart. Exemple :

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

Voici les en-têtes HTTP de premier niveau à utiliser lors d'une importation en plusieurs parties :

• Content-Type. Défini sur multipart/related et incluant la chaîne de délimitation que vous utilisez pour identifier les parties de la requête.
• Content-Length. Défini sur le nombre total d'octets dans le corps de la requête. La partie média de la requête doit être inférieure à la taille de fichier maximale définie pour cette méthode.

Le corps de la requête est mis en forme en tant que type de contenu multipart/related [RFC2387] et contient exactement deux parties. Les parties sont identifiées par une chaîne de délimitation, et la dernière chaîne est suivie de deux traits d'union.

Chaque partie de la requête en plusieurs parties nécessite un en-tête Content-Type supplémentaire :

1. Partie de métadonnées : doit apparaître en premier. La valeur Content-Type doit correspondre à l'un des formats de métadonnées acceptés.
2. Partie média : doit apparaître en second. La valeur Content-Type doit correspondre à l'un des types MIME de médias acceptés pour la méthode.

Exemples

Vous importez des éléments multimédias à l'aide de l'API Display & Video 360 pour effectuer diverses tâches. Cette section fournit des exemples de requêtes curl.

Importer un asset de création

Voici comment importer un asset de création :

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"

Pour en savoir plus et obtenir des exemples de code, consultez le guide Importer des assets de création.

Importer un fichier de script d'enchères personnalisées

Voici comment importer un fichier 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

Pour en savoir plus et obtenir des exemples de code, consultez le guide sur le script d'importation.