REST Resource: advertisers.manualTriggers

Zasób: ManualTrigger

Pojedyncza reguła ręczna w Display & Video 360.

Ostrzeżenie: elementy zamówienia korzystające z reguł ręcznych nie wyświetlają się już w Display & Video 360. Ten zasób zostanie wycofany 1 sierpnia 2023 r. Więcej informacji znajdziesz w naszym ogłoszeniu o wycofaniu funkcji.

Zapis JSON 
{
  "name": string,
  "advertiserId": string,
  "triggerId": string,
  "displayName": string,
  "activationDurationMinutes": string,
  "latestActivationTime": string,
  "state": enum (State)
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu aktywatora ręcznego.
advertiserId

string (int64 format)

To pole jest wymagane. Stałe. Unikalny identyfikator reklamodawcy, do którego należy reguła ręczna.
triggerId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator reguły ręcznej.
displayName

string

To pole jest wymagane. Wyświetlana nazwa aktywatora ręcznego.

Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów.
activationDurationMinutes

string (int64 format)

To pole jest wymagane. Maksymalny czas trwania każdej aktywacji w minutach. Wartość musi mieścić się w przedziale od 1 do 360 włącznie. Po tym czasie reguła zostanie automatycznie wyłączona.
latestActivationTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktywacji reguły.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
state

enum (State)

Tylko dane wyjściowe. Stan reguły ręcznej. Po utworzeniu zostanie ustawiony stan INACTIVE.

Stan

Stan aktywatora ręcznego.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna, gdy stan nie jest określony lub jest w tej wersji nieznany.
INACTIVE Reguła jest obecnie nieaktywna i gotowa do aktywacji.
ACTIVE Reguła jest obecnie aktywna (aktywowana).

Metody

activate

 Aktywuje wyzwalacz ręczny.

create

 Tworzy nową regułę ręczną.

deactivate

 Dezaktywuje aktywator ręczny.

get

 Pobiera aktywator ręczny.

list

 Zawiera listę reguł ręcznych, które są dostępne dla bieżącego użytkownika o danym identyfikatorze reklamodawcy.

patch

 Aktualizuje wyzwalacz ręczny.