UserListLicensePricing

使用者清單授權價格。

JSON 表示法
{
  "pricingId": string,
  "startTime": string,
  "endTime": string,
  "pricingActive": boolean,
  "buyerApprovalState": enum (UserListPricingBuyerApprovalState),
  "costMicros": string,
  "currencyCode": string,
  "costType": enum (UserListPricingCostType),
  "maxCostMicros": string
}
欄位
pricingId

string (int64 format)

僅供輸出。這項價格的 ID。

startTime

string (Timestamp format)

僅供輸出。定價的開始時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

endTime

string (Timestamp format)

(選用步驟) 價格的結束時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

pricingActive

boolean

僅供輸出。這項價格是否有效。

buyerApprovalState

enum (UserListPricingBuyerApprovalState)

僅供輸出。這項價格的買方核准狀態。

這是唯讀欄位。

costMicros

string (int64 format)

(選用步驟) 與模型相關聯的費用,以微量單位 (10^-6) 表示,幣別由 currencyCode 欄位指定。舉例來說,如果 currencyCodeUSD,則 2000000 代表 $2。

currencyCode

string

(選用步驟) 指定費用和 max_cost 的幣別。必須是 ISO 4217 定義的三字母貨幣代碼。

costType

enum (UserListPricingCostType)

不可變動。這項定價的費用類型。

只能在 create 作業中設定。現有授權無法更新。

maxCostMicros

string (int64 format)

(選用步驟) 使用 MEDIA_SHARE 費用類型時,系統向電子商務目標對象收取的最高千次曝光出價。這個值以微量單位 (10^-6) 表示,並以 currencyCode 欄位指定的貨幣為單位。舉例來說,如果 currencyCodeUSD,則 2000000 代表 $2。

只有在 costType 為 MEDIA_SHARE 時,這項屬性才適用。如果 costType 不是 MEDIA_SHARE,且已設定這個欄位,系統會傳回 MAX_COST_NOT_ALLOWED 錯誤。如果未設定或設為 0,則沒有上限。

UserListPricingBuyerApprovalState

使用者名單定價買方核准狀態。

列舉
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED UNSPECIFIED。
PENDING 使用者名單用戶端尚未接受使用者名單擁有者設定的價格條款。
APPROVED 使用者名單用戶端已接受使用者名單擁有者設定的價格條款。
REJECTED 使用者名單用戶端已拒絕使用者名單擁有者設定的價格條件。

UserListPricingCostType

使用者名單定價費用類型。

列舉
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED 未指明
CPC 單次點擊出價。
CPM 每千次曝光出價。
MEDIA_SHARE 分享媒體。