REST Resource: curators.dataSegments

Tài nguyên: Phân khúc dữ liệu

Xác định giá trị nhận dạng cho một phân khúc khoảng không quảng cáo mà người tuyển chọn hoặc chuyên viên kế hoạch truyền thông có thể nhắm đến trong giao diện người dùng của gói đấu giá hoặc giao dịch. Việc tuyển chọn khoảng không quảng cáo do người tuyển chọn thực hiện trên các nền tảng bên ngoài. -- Next ID: 9 --

Biểu diễn dưới dạng JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "userListId": string
}
Trường
name

string

Không thể thay đổi. Giá trị nhận dạng. Giá trị nhận dạng riêng biệt của phân khúc dữ liệu. Mã tài khoản tương ứng với mã tài khoản đã tạo phân khúc. Định dạng curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo phân khúc dữ liệu.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm phân khúc dữ liệu được cập nhật gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

state

enum (State)

Chỉ có đầu ra. Trạng thái của phân khúc dựa trên dữ liệu.

Phí sẽ được tính khi các tài khoản khác sử dụng phân khúc dữ liệu này. Ví dụ: khi các tài khoản khác thêm phân khúc dữ liệu này vào một giao dịch hoặc gói đấu giá. Bạn không thể thay đổi loại phí của phân khúc dựa trên dữ liệu sau khi đặt. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
cpmFee

object (Money)

Không bắt buộc. Phí cố định được tính cho mỗi nghìn lượt hiển thị. Sau khi đặt, bạn không thể thay đổi mã tiền tệ.

millipercentOfMediaFee

string (int64 format)

Không bắt buộc. Phí sẽ được tính theo tỷ lệ phần trăm của chi phí cho mỗi lượt hiển thị, được biểu thị bằng phần nghìn phần trăm. Ví dụ: 1% được biểu thị là 1000.

Kết thúc các trường loại trừ lẫn nhau.
userListId

string

Không bắt buộc. Không thể thay đổi. Mã nhận dạng của Danh sách người dùng được gói trong Phân khúc dữ liệu này.

Người quản lý có tài khoản Đối tác dữ liệu được liên kết có thể tạo một phân khúc dữ liệu bao gồm danh sách người dùng thuộc sở hữu của tài khoản Đối tác dữ liệu được liên kết. Bạn có thể tải danh sách người dùng lên và quản lý danh sách đó bằng Data Manager API. Việc liên kết danh sách người dùng với một phân khúc dữ liệu cho phép bạn xác định một phân khúc khoảng không quảng cáo dựa trên đối tượng mà bạn tạo.

Tiểu bang

Chỉ có đầu ra. Sử dụng phương thức kích hoạt và huỷ kích hoạt để thay đổi trạng thái.

Enum
STATE_UNSPECIFIED Giá trị mặc định.
ACTIVE Phân khúc dữ liệu đang hoạt động.
INACTIVE Phân khúc dữ liệu không hoạt động.
SUSPENDED Phân khúc dữ liệu bị tạm ngưng và không thể kích hoạt.

Phương thức

activate

Kích hoạt một phân khúc dựa trên dữ liệu.

create

Tạo một phân khúc dữ liệu thuộc sở hữu của người tuyển chọn trong danh sách.

deactivate

Huỷ kích hoạt một phân khúc dựa trên dữ liệu.

get

Lấy một phân khúc dữ liệu theo tên của phân khúc đó.

list

Liệt kê các phân khúc dữ liệu do một người tuyển chọn sở hữu.

patch

Cập nhật phân khúc dựa trên dữ liệu.