Przepływy pracy interfejsu API

W tym przewodniku opisujemy typowe procesy interfejsu API służące do tworzenia, pobierania i aktualizowania pakietów aukcji w Display &Video 360.

Pobieranie listy pakietów aukcji

Wywołaj interfejs LIST API. Obsługuje filtrowanie według external_deal_id.

Tworzenie nowego pakietu aukcji

1. Wartość external_deal_id musi być unikalna. Wywołaj interfejs LIST API z parametrem external_deal_id, aby sprawdzić, czy ten identyfikator został już użyty.
2. Wywołaj interfeż Create API. Zostanie przypisana unikalna nazwa, której można użyć do pobrania utworzonego pakietu.
3. Wywołaj interfejs Get API , aby wyświetlić szczegóły utworzonego pakietu aukcji.
4. Opcjonalnie, Prześlij logo utworzonego pakietu.

Aktualizowanie pakietu aukcji

1. Jeśli nie przechowujesz nazwy utworzonego pakietu aukcji, wywołaj interfejs LIST API z filtrem external_deal_id aby pobrać pakiet aukcji, który chcesz zaktualizować.
2. Zaktualizuj pola na podstawie wyników z interfejsu LIST API.
3. Wywołaj interfejs Patch API , aby zaktualizować pakiet aukcji. Wymagany jest parametr updateMask. Określa on, które pola mają zostać zaktualizowane. W parametrze updateMask można ustawić tylko pola, które można zaktualizować.

Proces testowania wersji beta

Jedyna różnica między wersją beta a wersją ogólnodostępną polega na tym, że w wersji beta utworzone pakiety aukcji muszą mieć stan ustawiony na DISCOVERY_OBJECT_STATUS_PAUSED, a stanu nie można zaktualizować. Pakiety wstrzymane nie są widoczne w interfejsie DV360. Dzięki temu giełdy mogą testować integrację z interfejsem API bez wyświetlania pakietów testowych.

Zwykle wszystkie „prawdziwe” pakiety są tworzone w wersji beta jako WSTRZYMANE, a następnie aktywowane w wersji ogólnodostępnej.

Quota

2000 aktywnych pakietów na giełdę.

2000 wstrzymanych pakietów na giełdę.