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 规范化(即转换为 UTC 零时区格式并在末尾附加 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 规范化(即转换为 UTC 零时区格式并在末尾附加 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 未指定。
PENDING 用户名单客户尚未接受用户名单所有者设置的定价条款。
APPROVED 用户名单客户已接受用户名单所有者设置的定价条款。
REJECTED 用户名单客户拒绝了用户名单所有者设置的定价条款。

UserListPricingCostType

用户名单定价费用类型。

枚举
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED 未指定。
CPC 每次点击费用。
CPM 每千次展示费用。
MEDIA_SHARE 媒体分享。