Workflows des API

Ce guide décrit les workflows d'API courants pour créer, récupérer et mettre à jour des packages d'enchères dans Display &Video 360.

Obtenir la liste des packages d'enchères

Appelez l'API LIST API. Le filtrage par external_deal_id est accepté.

Créer un package d'enchères

1. external_deal_id doit être unique. Appelez LIST avec external_deal_id pour voir si l'ID a déjà été utilisé.
2. Appelez l'API Create API. Un nom unique sera attribué et pourra être utilisé pour obtenir le package créé.
3. Appelez l'API Get API pour afficher les détails du package d'enchères créé.
4. Vous pouvez également importer un logo pour le package créé.

Mettre à jour le package d'enchères

1. Si vous ne stockez pas le nom du package d'enchères créé, appelez l'API LISTfiltrée par external_deal_id pour obtenir le package d'enchères que vous souhaitez mettre à jour.
2. Mettez à jour les champs en fonction des résultats de l'API LIST.
3. Appelez l'API Patch pour mettre à jour le package d'enchères. updateMask est obligatoire. Il indique les champs auxquels vous souhaitez appliquer la mise à jour. Seuls les champs qui peuvent être mis à jour peuvent être définis dans updateMask.

Processus bêta

La seule différence entre la version bêta et la version DG est que, pendant la version bêta, les packages d'enchères créés doivent avoir l'état DISCOVERY_OBJECT_STATUS_PAUSED, et cet état ne peut pas être mis à jour. Les packages PAUSED ne sont pas visibles dans l'UI DV360. Cela permet aux Ad Exchanges 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, puis de les activer une fois dans la version DG.

Quota

2 000 packages actifs par Ad Exchange.

2 000 packages mis en pause par Ad Exchange.