- Zasób: RecommendeddOrder
- GuaranteedOrderStatus (Stan zamówienia gwarantowanego)
- GuaranteedOrderConfigStatus
- Metody
Zasób: RecommendeddOrder
Zamówienie gwarantowane.
Zamówienia gwarantowane są elementem nadrzędnym w przypadku gwarantowanych źródeł zasobów reklamowych. Podczas tworzenia źródła gwarantowanych zasobów reklamowych musisz przypisać do niego identyfikator zamówienia.
Zapis JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu zamówienia gwarantowanego. |
legacyGuaranteedOrderId |
Tylko dane wyjściowe. Starszy identyfikator zamówienia gwarantowanego. Przypisana przez pierwotną giełdę. Starszy identyfikator jest unikalny w obrębie jednej giełdy, ale nie musi być niepowtarzalny we wszystkich gwarantowanych zamówieniach. Ten identyfikator jest używany w plikach SDF i interfejsie. |
exchange |
To pole jest wymagane. Stałe. Giełda, z której pochodzi zamówienie gwarantowane. |
guaranteedOrderId |
Tylko dane wyjściowe. Unikalny identyfikator zamówienia gwarantowanego. Identyfikatory zamówień gwarantowanych mają format |
displayName |
To pole jest wymagane. Wyświetlana nazwa zamówienia gwarantowanego. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów. |
status |
Ustawienia stanu zamówienia gwarantowanego. |
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji zamówienia gwarantowanego. Przypisana przez system. Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
publisherName |
To pole jest wymagane. Nazwa wydawcy zamówienia gwarantowanego. Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów. |
readAccessInherited |
Określa, czy wszyscy reklamodawcy w organizacji |
readAdvertiserIds[] |
Identyfikatory reklamodawców z dostępem do odczytu do zamówienia gwarantowanego. To pole nie może zawierać reklamodawcy przypisanego do |
defaultAdvertiserId |
Tylko dane wyjściowe. Identyfikator domyślnego reklamodawcy zamówienia gwarantowanego. Reklamodawca domyślny to |
defaultCampaignId |
Identyfikator domyślnej kampanii przypisanej do zamówienia gwarantowanego. Kampania domyślna musi należeć do reklamodawcy domyślnego. |
Pole sumy Partner lub reklamodawca z uprawnieniami do odczytu i zapisu w ramach gwarantowanego zamówienia. |
|
readWritePartnerId |
Partner z uprawnieniami do zapisu i odczytu w zamówieniu gwarantowanym. |
readWriteAdvertiserId |
Reklamodawca z uprawnieniami do zapisu i odczytu w zamówieniu gwarantowanym. Jest to też domyślny reklamodawca zamówienia gwarantowanego. |
GuaranteedOrderStatus
Ustawienia stanu zamówienia gwarantowanego.
Zapis JSON |
---|
{ "entityStatus": enum ( |
Pola | |
---|---|
entityStatus |
Wskazuje, czy zamówienie gwarantowane może zostać wyświetlone. Akceptowane wartości to |
entityPauseReason |
Podana przez użytkownika przyczyna wstrzymania tego zamówienia gwarantowanego. Musi być zakodowany w formacie UTF-8 o maksymalnej długości 100 bajtów. Ma zastosowanie tylko wtedy, gdy zasada |
configStatus |
Tylko dane wyjściowe. Stan konfiguracji zamówienia gwarantowanego. Akceptowane wartości to Przed wyświetleniem gwarantowanego zamówienia musisz je skonfigurować (wypełnij wymagane pola, wybierz kreacje i wybierz kampanię domyślną). Obecnie działanie konfiguracyjne można wykonywać tylko przez interfejs użytkownika. |
GuaranteedOrderConfigStatus
Możliwe stany konfiguracji zamówienia gwarantowanego.
Wartości w polu enum | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
W tej wersji stan zatwierdzenia nie jest określony lub jest nieznany. |
PENDING |
Stan początkowy zamówienia gwarantowanego. Zanim reklama będzie mogła się wyświetlać, musisz skonfigurować kolejność gwarantowaną w tym stanie. |
COMPLETED |
Stan po skonfigurowaniu zamówienia gwarantowanego przez kupującego. |
Metody |
|
---|---|
|
Tworzy nowe zamówienie gwarantowane. |
|
Zmiany odczytują reklamodawców zamówienia gwarantowanego. |
|
Otrzymuje zamówienie gwarantowane. |
|
Wyświetla listę gwarantowanych zamówień, które są dostępne dla bieżącego użytkownika. |
|
Aktualizuje istniejące zamówienie gwarantowane. |