# UserListLicensePricing

- [JSON representation](https://developers.google.com/data-manager/api/reference/rest/v1/UserListLicensePricing#SCHEMA_REPRESENTATION)
- [UserListPricingBuyerApprovalState](https://developers.google.com/data-manager/api/reference/rest/v1/UserListLicensePricing#UserListPricingBuyerApprovalState)
- [UserListPricingCostType](https://developers.google.com/data-manager/api/reference/rest/v1/UserListLicensePricing#UserListPricingCostType)

A user list license pricing.

| JSON representation |
|---|
| ``` { "pricingId": string, "startTime": string, "endTime": string, "pricingActive": boolean, "buyerApprovalState": enum (`https://developers.google.com/data-manager/api/reference/rest/v1/UserListLicensePricing#UserListPricingBuyerApprovalState`), "costMicros": string, "currencyCode": string, "costType": enum (`https://developers.google.com/data-manager/api/reference/rest/v1/UserListLicensePricing#UserListPricingCostType`), "maxCostMicros": string } ``` |

| Fields ||
|---|---|
| `pricingId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The ID of this pricing. |
| `startTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Start time of the pricing. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `endTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Optional. End time of the pricing. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `pricingActive` | `boolean` Output only. Whether this pricing is active. |
| `buyerApprovalState` | ``enum (`https://developers.google.com/data-manager/api/reference/rest/v1/UserListLicensePricing#UserListPricingBuyerApprovalState`)`` Output only. The buyer approval state of this pricing. This field is read-only. |
| `costMicros` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. The cost associated with the model, in micro units (10\^-6), in the currency specified by the currencyCode field. For example, 2000000 means $2 if `currencyCode` is `USD`. |
| `currencyCode` | `string` Optional. The currency in which cost and max_cost is specified. Must be a three-letter currency code defined in ISO 4217. |
| `costType` | ``enum (`https://developers.google.com/data-manager/api/reference/rest/v1/UserListLicensePricing#UserListPricingCostType`)`` Immutable. The cost type of this pricing. Can be set only in the `create` operation. Can't be updated for an existing license. |
| `maxCostMicros` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. The maximum CPM a commerce audience can be charged when the MEDIA_SHARE cost type is used. The value is in micro units (10\^-6) and in the currency specified by the currencyCode field. For example, 2000000 means $2 if `currencyCode` is `USD`. This is only relevant when costType is MEDIA_SHARE. When costType is not MEDIA_SHARE, and this field is set, a MAX_COST_NOT_ALLOWED error will be returned. If not set or set to`0`, there is no cap. |

## UserListPricingBuyerApprovalState

User list pricing buyer approval state.

| Enums ||
|---|---|
| `USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED` | UNSPECIFIED. |
| `PENDING` | User list client has not yet accepted the pricing terms set by the user list owner. |
| `APPROVED` | User list client has accepted the pricing terms set by the user list owner. |
| `REJECTED` | User list client has rejected the pricing terms set by the user list owner. |

## UserListPricingCostType

User list pricing cost type.

| Enums ||
|---|---|
| `USER_LIST_PRICING_COST_TYPE_UNSPECIFIED` | Unspecified. |
| `CPC` | Cost per click. |
| `CPM` | Cost per mille (thousand impressions). |
| `MEDIA_SHARE` | Media share. |