Obtenir la liste des packages d'enchères
Appelez l'API LIST. Filtrage par external_deal_id
Créer un package d'enchères
- external_deal_id doit être unique. Appelez LIST avec external_deal_id pour voir si l'ID a déjà été utilisé.
- Appelez Create API. Un nom unique sera attribué et pourra être utilisé pour obtenir le package créé.
- Appelez Get API pour afficher les détails du package d'enchères créé.
- Si vous le souhaitez, importez un logo pour le package créé.
Mettre à jour le package d'enchères
- Si vous ne stockez pas le nom du package d'enchères créé, appelez le filtre LIST API par external_deal_id pour obtenir le package d'enchères que vous souhaitez mettre à jour.
- Mettez à jour les champs en fonction des résultats de l'API LIST.
- Appelez l'API Patch pour mettre à jour le package d'enchères. Le paramètre "updateMask" est obligatoire. Il indique les champs auxquels vous souhaitez appliquer la mise à jour. Seuls les champs pouvant être mis à jour peuvent être définis dans "updateMask".
Processus bêta
La seule différence entre la version bêta et la version GA est que, pendant la version bêta, les packages d'enchères créés doivent avoir l'état "DISCOVERY_OBJECT_STATUS_PAUSED" et que cet état ne peut pas être modifié. Les packages SUSPENDUS ne sont pas visibles dans l'UI DV3. Cela permet aux plates-formes d'échange de tester l'intégration de l'API sans afficher les packages de test.
Il est courant de créer tous les packages "réels" en version bêta avec l'état "PAUSED" (SUSPENDU), puis de les "activer" une fois qu'ils sont disponibles en version GA.
Quota
2 000 packages actifs par plate-forme d'échange.
2 000 packages mis en veille par place de marché.