Zasób: gwarantowane zamówienie
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 należy do niego przypisać gwarantowany identyfikator zamówienia.
Zapis JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Nazwa zasobu gwarantowanego zamówienia. |
legacyGuaranteedOrderId |
Tylko dane wyjściowe. Starszy identyfikator zamówienia gwarantowanego. Przypisana przez pierwotną giełdę. Starszy identyfikator jest unikalny w ramach jednej giełdy, ale nie może być niepowtarzalny wśród wszystkich zamówień gwarantowanych. Ten identyfikator jest używany w plikach SDF i interfejsie użytkownika. |
exchange |
Wymagane. Stały. Giełda, z której pochodzi zamówienie gwarantowane. |
guaranteedOrderId |
Tylko dane wyjściowe. Unikalny identyfikator gwarantowanego zamówienia. Identyfikatory gwarantowanych zamówień mają format |
displayName |
Wymagane. Wyświetlana nazwa zamówienia gwarantowanego. Musi być zakodowany w standardzie UTF-8 i 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 RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
publisherName |
Wymagane. Nazwa wydawcy gwarantowanego zamówienia. Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów. |
readAccessInherited |
Określa, czy wszyscy reklamodawcy w organizacji |
readAdvertiserIds[] |
Identyfikatory reklamodawców z dostępem do odczytu gwarantowanego zamówienia. To pole nie może zawierać reklamodawcy przypisanego do |
defaultAdvertiserId |
Tylko dane wyjściowe. Identyfikator domyślnego reklamodawcy zamówienia gwarantowanego. Domyślnym reklamodawcą jest |
defaultCampaignId |
Identyfikator kampanii domyślnej przypisanej do gwarantowanego zamówienia. Kampania domyślna musi należeć do domyślnego reklamodawcy. |
Pole sumy Partner lub reklamodawca z uprawnieniami do odczytu i zapisu gwarantowanego zamówienia. |
|
readWritePartnerId |
Partner z uprawnieniami do odczytu i zapisu zamówienia gwarantowanego. |
readWriteAdvertiserId |
Reklamodawca z uprawnieniami do odczytu i zapisu gwarantowanego zamówienia. Jest to także domyślny reklamodawca gwarantowanego zamówienia. |
GuaranteedOrderStatus
Ustawienia stanu zamówienia gwarantowanego.
Zapis JSON |
---|
{ "entityStatus": enum ( |
Pola | |
---|---|
entityStatus |
Wskazuje, czy zamówienie gwarantowane może być wyświetlane. Akceptowane wartości to |
entityPauseReason |
Przyczyna wstrzymania tego gwarantowanego zamówienia podana przez użytkownika. Musi być zakodowany w standardzie UTF-8 o maksymalnej długości 100 bajtów. Ma zastosowanie tylko wtedy, gdy zasada |
configStatus |
Tylko dane wyjściowe. Stan konfiguracji gwarantowanego zamówienia. Akceptowane wartości to Zanim zamówienie gwarantowane będzie mogło się wyświetlać, musisz je skonfigurować (wypełnij wymagane pola, wybierz kreacje i wybierz kampanię domyślną). Obecnie działanie konfiguracyjne można wykonywać tylko w interfejsie użytkownika. |
GuaranteedOrderConfigStatus
Możliwe stany konfiguracji gwarantowanego zamówienia.
Wartości w polu enum | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
Stan zatwierdzenia nie jest określony lub nieznany w tej wersji. |
PENDING |
Stan początkowy gwarantowanego zamówienia. Zamówienie gwarantowane w tym stanie trzeba skonfigurować, aby mogło być wyświetlane. |
COMPLETED |
Stan, który pojawia się, gdy kupujący skonfiguruje zamówienie gwarantowane. |
Metody |
|
---|---|
|
Tworzy nowe zamówienie gwarantowane. |
|
Zmiany odczytują reklamodawców zamówienia gwarantowanego. |
|
Pobiera zamówienie gwarantowane. |
|
Zawiera listę zamówień gwarantowanych, które są dostępne dla bieżącego użytkownika. |
|
Aktualizuje istniejące zamówienie gwarantowane. |