REST Resource: advertisers.manualTriggers

Tài nguyên: Trình kích hoạt thủ công

Một điều kiện kích hoạt thủ công trong Display & Video 360.

Cảnh báo: Các mục hàng sử dụng trình kích hoạt thủ công không còn phân phát trong Display & Video 360 nữa. Tài nguyên này sẽ ngừng hoạt động từ ngày 1 tháng 8 năm 2023. Hãy đọc thông báo về việc ngừng sử dụng tính năng của chúng tôi để biết thêm thông tin.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "advertiserId": string,
  "triggerId": string,
  "displayName": string,
  "activationDurationMinutes": string,
  "latestActivationTime": string,
  "state": enum (State)
}
Các trường
name

string

Chỉ có đầu ra. Tên tài nguyên của điều kiện kích hoạt thủ công.

advertiserId

string (int64 format)

Bắt buộc. Không thể thay đổi. Mã nhận dạng duy nhất của nhà quảng cáo chứa điều kiện kích hoạt thủ công.

triggerId

string (int64 format)

Chỉ có đầu ra. Mã nhận dạng duy nhất của điều kiện kích hoạt thủ công.

displayName

string

Bắt buộc. Tên hiển thị của điều kiện kích hoạt thủ công.

Phải là mã UTF-8 với kích thước tối đa là 240 byte.

activationDurationMinutes

string (int64 format)

Bắt buộc. Thời lượng tối đa của mỗi lần kích hoạt tính bằng phút. Phải nằm trong khoảng từ 1 đến 360. Sau khoảng thời gian này, trình kích hoạt sẽ tự động bị tắt.

latestActivationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của lần kích hoạt gần đây nhất.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

state

enum (State)

Chỉ có đầu ra. Trạng thái của điều kiện kích hoạt thủ công. Sẽ được đặt thành trạng thái INACTIVE khi tạo.

Tiểu bang

Trạng thái của điều kiện kích hoạt thủ công.

Enum
STATE_UNSPECIFIED Giá trị mặc định khi trạng thái không được chỉ định hoặc không xác định trong phiên bản này.
INACTIVE Trình kích hoạt hiện không hoạt động và đã sẵn sàng để được kích hoạt.
ACTIVE Trình kích hoạt hiện đang hoạt động (đã kích hoạt).

Phương thức

activate

Kích hoạt trình kích hoạt thủ công.

create

Tạo trình kích hoạt thủ công mới.

deactivate

Tắt điều kiện kích hoạt thủ công.

get

Nhận được điều kiện kích hoạt thủ công.

list

Liệt kê những điều kiện kích hoạt thủ công mà người dùng hiện tại có thể truy cập cho một mã nhận dạng nhà quảng cáo nhất định.

patch

Cập nhật một điều kiện kích hoạt thủ công.