CustomInterest

自訂興趣。也就是依興趣區分的使用者清單。

JSON 表示法 
{
  "resourceName": string,
  "status": enum (CustomInterestStatus),
  "type": enum (CustomInterestType),
  "members": [
    {
      object (CustomInterestMember)
    }
  ],
  "id": string,
  "name": string,
  "description": string
}
欄位
resourceName

string

不可變動。自訂興趣的資源名稱。自訂興趣資源名稱的格式如下：

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

enum (CustomInterestStatus)

這個自訂興趣的狀態。指出自訂興趣是否已啟用或移除。
type

enum (CustomInterestType)

自訂興趣的類型，CUSTOM_AFFINITY 或 CUSTOM_INTENT。根據預設，類型會設為 CUSTOM_AFFINITY。
members[]

object (CustomInterestMember)

這個自訂興趣組成的自訂興趣成員清單。建立自訂興趣時可以新增成員。如果成員在 UPDATE 作業中顯示，現有成員會遭到覆寫。
id

string (int64 format)

僅供輸出。自訂興趣的 ID。
name

string

自訂興趣的名稱。同一自訂興趣相似目標對象中不得重複。這是建立作業的必填欄位。
description

string

這個自訂興趣目標對象的說明。

CustomInterestStatus

列舉包含可能的自訂興趣類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
ENABLED 已啟用狀態：已啟用自訂興趣，可指定目標。
REMOVED 已移除狀態：自訂興趣已移除，無法用於指定目標。

CustomInterestType

列舉包含可能的自訂興趣類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
CUSTOM_AFFINITY 允許品牌廣告主定義自訂關聯目標對象名單。
CUSTOM_INTENT 讓廣告主定義自訂意願目標對象名單。

CustomInterestMember

自訂興趣目標對象的成員。成員可以是關鍵字或網址。這是不可變的內容，也就是只能建立或移除，無法變更。

JSON 表示法 
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
欄位
memberType

enum (CustomInterestMemberType)

自訂興趣成員的類型，例如 KEYWORD 或網址。
parameter

string

如果 memberType 為 KEYWORD，則為關鍵字文字；如果 memberType 為 URL，則為網址字串。

CustomInterestMemberType

列舉包含可能的自訂興趣成員類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的不明值。
KEYWORD 自訂興趣成員類型：關鍵字。
URL 自訂興趣成員類型網址。