CustomInterest

Mối quan tâm tuỳ chỉnh. Đây là danh sách người dùng theo mối quan tâm.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "status": enum (CustomInterestStatus),
  "type": enum (CustomInterestType),
  "members": [
    {
      object (CustomInterestMember)
    }
  ],
  "id": string,
  "name": string,
  "description": string
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của mối quan tâm tuỳ chỉnh. Tên tài nguyên mối quan tâm tuỳ chỉnh có dạng:

customers/{customerId}/customInterests/{custom_interest_id}
status

enum (CustomInterestStatus)

Trạng thái của mối quan tâm tuỳ chỉnh này. Cho biết mối quan tâm tuỳ chỉnh được bật hay xoá.
type

enum (CustomInterestType)

Loại mối quan tâm tuỳ chỉnh, CUSTOM_AFFINITY hoặc CUSTOM_INTENT. Theo mặc định, loại này được đặt thành CUSTOM_AFFINITY.
members[]

object (CustomInterestMember)

Danh sách các thành phần của mối quan tâm tuỳ chỉnh mà mối quan tâm tuỳ chỉnh này bao gồm. Bạn có thể thêm thành viên trong quá trình tạo Mối quan tâm tuỳ chỉnh. Nếu các thành phần được trình bày trong toán tử UPDATE, thì các thành phần hiện có sẽ bị ghi đè.
id

string (int64 format)

Chỉ có đầu ra. Mã của mối quan tâm tuỳ chỉnh.
name

string

Tên của mối quan tâm tuỳ chỉnh. Đối tượng chung sở thích tùy chỉnh phải là duy nhất. Trường này là bắt buộc đối với các thao tác tạo.
description

string

Nội dung mô tả về đối tượng có mối quan tâm tuỳ chỉnh này.

CustomInterestStatus

Enum chứa các loại mối quan tâm tuỳ chỉnh có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
ENABLED Trạng thái bật – mối quan tâm tuỳ chỉnh được bật và có thể được nhắm đến.
REMOVED Trạng thái đã xoá – mối quan tâm tuỳ chỉnh sẽ bị xoá và không thể dùng để nhắm mục tiêu.

CustomInterestType

Enum chứa các loại mối quan tâm tuỳ chỉnh có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
CUSTOM_AFFINITY Cho phép nhà quảng cáo thương hiệu xác định danh sách đối tượng chung sở thích tuỳ chỉnh.
CUSTOM_INTENT Cho phép nhà quảng cáo xác định danh sách đối tượng có ý định tuỳ chỉnh.

CustomInterestMember

Một thành viên của đối tượng theo mối quan tâm tuỳ chỉnh. Thành phần có thể là từ khoá hoặc URL. Thuộc tính này không thể thay đổi, tức là bạn chỉ có thể tạo hoặc xoá thuộc tính này chứ không thể thay đổi.

Biểu diễn dưới dạng JSON 
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
Trường
memberType

enum (CustomInterestMemberType)

Loại thành viên có mối quan tâm tuỳ chỉnh, KEYWORD hoặc URL.
parameter

string

Văn bản từ khoá khi memberType là KEYWORD hoặc chuỗi URL khi memberType là URL.

CustomInterestMemberType

Enum chứa các loại thành viên mối quan tâm tuỳ chỉnh có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
KEYWORD Loại thành phần của mối quan tâm tuỳ chỉnh: TỪ KHÓA.
URL URL loại thành viên có mối quan tâm tuỳ chỉnh.