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

位成員 Type 為 KEYWORD 時，關鍵字文字是 KEYWORD 網址字串。

CustomInterestMemberType

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

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
KEYWORD 自訂興趣成員類型「KEYWORD」。
URL 自訂興趣成員類型網址。