REST Resource: advertisers.manualTriggers

Zasób: ManualTrigger

Pojedyncza reguła ręczna w kampaniach w sieci reklamowej Film 360.

Ostrzeżenie: elementy zamówienia korzystające z reguł ręcznych nie wyświetlają już reklam w sieci reklamowej Film 360. Ten zasób zostanie wycofany 1 sierpnia 2023 r. Aby dowiedzieć się więcej, przeczytaj ogłoszenie 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)

Wymagane. Stały. Unikalny identyfikator reklamodawcy, do którego należy reguła ręczna.

triggerId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator aktywatora ręcznego.

displayName

string

Wymagane. Wyświetlana nazwa reguły ręcznej.

Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.

activationDurationMinutes

string (int64 format)

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 aktywatora.

Sygnatura czasowa w RFC3339 UTC „Zulu” 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 reguły ręcznej.

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

Metody

activate

Aktywuje regułę ręczną.

create

Tworzy nowy aktywator ręczny.

deactivate

Dezaktywuje aktywator ręczny.

get

Pobiera aktywator ręczny.

list

Zawiera listę reguł ręcznych, które w przypadku danego identyfikatora reklamodawcy są dostępne dla bieżącego użytkownika.

patch

Aktualizuje regułę ręczną.