Creative Upload Service - Format de fichier

Le service Chargement créatif permet de charger un fichier et d’obtenir un objet multimédia en retour.

Remarque

Les ressources multimédias qui ne sont pas associées à un élément créatif peuvent être nettoyées à tout moment.

Vue d’ensemble du format

Le service de chargement créatif est une publication de formulaire en plusieurs parties. Quelques paramètres sont nécessaires pour construire le billet.

Le tableau suivant décrit l’ordre des formulaires qui composent le billet :

Autorisation

Nom	Type	Description	Exemple
`Authorization`	string	Jeton reçu lors de l’authentification auprès de l’API AppNexus.	`"hbapi:108172:05866d06f6964:nym2"`

Pour plus d’informations, consultez Authentification d’API.

Type de formulaire

Utilisez le premier formulaire pour définir le type de fichier que vous souhaitez charger.

Nom	Type	Description	Exemple
`form`	string	Définissez le type de fichier que vous souhaitez charger.	`--form "type=video"`

Types de fichiers acceptés

Type	Valeur
`html`	« zip ».
`video`	« webm »,"mkv »,"converter »,"vob »,"ogv »,"ogg »,"avi »,"mov »,"qt »,"wmv »,"rm »,"asf »,"mp4 »,"m4p »,"m4v »,"mpg »,"mp2 »,"mpeg »,"mpe »,"mpv »,"m2v »,"m4v »,"m4v », « 3gp »,"3g2 »,"f4v »,"f4p »,"f4a »,"f4b », « swf ».
`audio`	« aac »,"webm »,"mkv »,"tm »,"vob »,"ogv »,"ogg »,"avi »,"mov »,"qt »,"wmv »,"rm »,"asf »,"mp3 »,"mp4 »,"m4p »,"m4v »,"mpg »,"mp2 »,"mpeg »,"mpe »,"mpv », « m2v »,"m4v »,"3gp »,"3g2 »,"f4v »,"f4p »,"f4a »,"f4b », « swf », « wav ».
`image`	« jpeg », « jpg », « gif », « png », « swf ».
`default`

Remarque

.mov vidéos seront lues dans tous les navigateurs une fois le transcodage terminé, mais il peut y avoir un retard dans la préversion.

Chargement de fichier de formulaire

Utilisez le formulaire suivant pour définir le chemin d’accès au fichier que vous souhaitez charger.

Nom	Type	Description	Exemple
`form`	string	Définissez le chemin d’accès au fichier que vous souhaitez charger.	`--form "file=@/Folder1/Folder2/Downloads/IMG_0332.JPG"`

AppNexus API

Définissez l’URL de l’API AppNexus et pointez vers le point de creative-upload terminaison. L’ID de membre est requis.

Nom	Type	Description	Exemple
`URL`	string	Définissez le protocole HTTP et le point de `creative-upload` terminaison.	`"https://api.appnexus.com/creative-upload?member_id=123"`

Exemple

L’exemple suivant illustre un scénario dérivé d’un cas d’usage réel.

Un client charge un fichier image dans le membre 123.

Champ	Valeur
`Authorization`	`hbapi:139072:5761726637ada:nym2`
`Form Type`	`image`
`Form File Upload`	`Folder1/Folder2/IMG_0332.JPG`
`AppNexus API`	`https://api.appnexus.com/creative-upload?member_id=12`

Un client charge un fichier image dans le membre 123

curl -X POST -H "Authorization: hbapi:139072:5761726637ada:nym2" --form "type=image" --form "file=@/Folder1/Folder2/IMG_0332.JPG" "https://api.appnexus.com/creative-upload?member_id=123"

"response":{  
      "status":"OK",
      "count":0,
      "start_element":0,
      "num_elements":0,
      "dbg_info":{  
         "instance":"05.media-asset-pipeline.prod.nym2",
         "db":"",
         "warnings":[  

         ],
         "start_microtime":1492716035.805,
         "time":5,
         "version":"",
         "output_term":"media-asset"
      },
      "media-asset":[  
         {  
            "id":1536691,
            "parent_media_asset_id":null,
            "member_id":123,
            "advertiser_id":null,
            "publisher_id":null,
            "file_name":"IMG_0332.JPG",
            "size_in_bytes":79400,
            "cdn_uploaded_on":null,
            "cdn_url":"http://vcdn.adnxs.com/p/creative-image/1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
            "cdn_secure_url":"https://vcdn.adnxs.com/p/creative-image/1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
            "created_on":"2017-04-20 19:20:35",
            "last_modified":"2017-04-20 19:20:35",
            "deleted":false,
            "media_asset_status":[  
               {  
                  "id":1536687,
                  "media_asset_id":1536691,
                  "error_message":null,
                  "local_path":"1b/ee/3d/95/1bee3d95-7042-4e10-b0bf-7f43e2e4322a.JPG",
                  "cdn_upload_attempt_count":0,
                  "created_on":"2017-04-20 19:20:35",
                  "last_modified":"2017-04-20 19:20:35",
                  "deleted":false,
                  "status":"on_shared_storage"
               }
            ],
            "media_asset_image":{  
               "id":1005450,
               "media_asset_id":1536691,
               "height":480,
               "width":640,
               "created_on":"2017-04-20 19:20:35",
               "last_activity":"2017-04-20 19:20:35",
               "deleted":false
            },
            "media_asset_video":null,
            "media_asset_html5":null,
            "asset_type":"image",
            "mime_type":"image/jpeg"
         }
      ]
   }
   }

Last updated on 2025-10-22

Partager via