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. Niezmienne. 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. Wymagana wartość z zakresu od 1 do 360 włącznie. Po upływie tego czasu reguła zostanie automatycznie zdezaktywowana.

latestActivationTime

string (Timestamp format)

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

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy 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 nieznany w tej wersji.
INACTIVE Reguła jest obecnie nieaktywna i gotowa do aktywacji.
ACTIVE Aktywator jest obecnie aktywny.

Metody

activate

Aktywuje wyzwalacz ręczny.

create

Tworzy nową regułę ręczną.

deactivate

Dezaktywuje regułę ręczną.

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.