Zasób: GuaranteedOrder
Zamówienie gwarantowane.
Zamówienia gwarantowane są nadrzędnym elementem źródeł zasobów reklamowych gwarantowanych. Podczas tworzenia źródła gwarantowanych zasobów reklamowych musisz przypisać do niego identyfikator zamówienia gwarantowanego.
Zapis JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu gwarantowanego zamówienia. |
legacyGuaranteedOrderId |
Tylko dane wyjściowe. Stary identyfikator zamówienia gwarantowanego. Przypisano je przez pierwotną giełdę. Stary identyfikator jest unikalny na jednej giełdzie, ale nie ma gwarancji, że będzie unikalny w przypadku wszystkich zamówień gwarantowanych. Ten identyfikator jest używany w SDF i UI. |
exchange |
Wymagany. Niezmienna. Giełda, na której powstało zamówienie gwarantowane. |
guaranteedOrderId |
Tylko dane wyjściowe. Unikalny identyfikator zamówienia gwarantowanego. Identyfikatory zamówień gwarantowanych mają format |
displayName |
Wymagany. Wyświetlana nazwa zamówienia gwarantowanego. Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów. |
status |
Ustawienia stanu zamówienia gwarantowanego. |
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji zamówienia gwarantowanego. Przypisany przez system. Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są również przesunięcia inne niż „Z”. Przykłady: |
publisherName |
Wymagany. Nazwa wydawcy zamówienia gwarantowanego. Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów. |
readAccessInherited |
Określ, czy wszyscy reklamodawcy w |
readAdvertiserIds[] |
Identyfikatory reklamodawców z dostępem tylko do odczytu do zamówienia gwarantowanego. To pole nie może zawierać reklamodawcy przypisanego do pola |
defaultAdvertiserId |
Tylko dane wyjściowe. Identyfikator domyślnego reklamodawcy zamówienia gwarantowanego. Domyślny reklamodawca to |
defaultCampaignId |
Identyfikator kampanii domyślnej przypisanej do zamówienia gwarantowanego. Kampania domyślna musi należeć do reklamodawcy domyślnego. |
Pole unii Partner lub reklamodawca z dostępem do zamówienia gwarantowanego na potrzeby odczytu/zapisu. |
|
readWritePartnerId |
Partner z dostępem do odczytu i zapisu do zamówienia gwarantowanego. |
readWriteAdvertiserId |
Reklamodawca z dostępem do odczytu i zapisu do zamówienia gwarantowanego. Jest to też domyślny reklamodawca zamówienia gwarantowanego. |
GuaranteedOrderStatus
Ustawienia stanu zamówienia gwarantowanego.
Zapis JSON |
---|
{ "entityStatus": enum ( |
Pola | |
---|---|
entityStatus |
Określa, czy zamówienie gwarantowane jest dostępne do wyświetlenia. Akceptowane wartości to |
entityPauseReason |
Podany przez użytkownika powód wstrzymania tego zamówienia gwarantowanego. Musi być zakodowany w formacie UTF-8 i mieć maksymalnie 100 bajtów. Dotyczy tylko sytuacji, gdy |
configStatus |
Tylko dane wyjściowe. Stan konfiguracji zamówienia gwarantowanego. Akceptowane wartości to Zanim zamówienie gwarantowane będzie mogło się wyświetlać, musi zostać skonfigurowane (wypełnij wymagane pola, wybierz kreacje i kampanię domyślną). Obecnie działanie konfiguracyjne można wykonać tylko w interfejsie użytkownika. |
GuaranteedOrderConfigStatus
Możliwe stany konfiguracji zamówienia gwarantowanego.
Wartości w polu enum | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
Stan zatwierdzenia nie jest określony lub jest nieznany w tej wersji. |
PENDING |
Początkowy stan zamówienia gwarantowanego. Zanim zamówienie gwarantowane będzie mogło się wyświetlać, musi zostać skonfigurowane w tym stanie. |
COMPLETED |
Stan po skonfigurowaniu przez kupującego zamówienia gwarantowanego. |
Metody |
|
---|---|
|
Tworzy nowe zamówienie z gwarancją. |
|
Edytuje odczyt reklamodawców w zamówieniu gwarantowanym. |
|
Otrzymuje zamówienie gwarantowane. |
|
Wyświetla zamówienia z gwarancją dostępności, które są dostępne dla bieżącego użytkownika. |
|
Aktualizuje istniejące zamówienie gwarantowane. |