- [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#SCHEMA_REPRESENTATION)
- [PartnerCostType](https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostType)
- [PartnerCostFeeType](https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostFeeType)
- [PartnerCostInvoiceType](https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostInvoiceType)

Settings that control a partner cost.

A partner cost is any type of expense involved in running a campaign, other than the costs of purchasing impressions (which is called the media cost) and using third-party audience segment data (data fee). Some examples of partner costs include the fees for using DV360, a third-party ad server, or a third-party ad serving verification service.

| JSON representation |
|---|
| ``` { "costType": enum (`https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostType`), "feeType": enum (`https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostFeeType`), "invoiceType": enum (`https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostInvoiceType`), // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "feeAmount": string, "feePercentageMillis": string // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `costType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostType`)`` Required. The type of the partner cost. |
| `feeType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostFeeType`)`` Required. The fee type for this partner cost. |
| `invoiceType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#PartnerCostInvoiceType`)`` The invoice type for this partner cost. - Required when `https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#FIELDS.cost_type` is one of: - `PARTNER_COST_TYPE_ADLOOX` - `PARTNER_COST_TYPE_DOUBLE_VERIFY` - `PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE`. - Output only for other types. |
| Applicable when the `https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#FIELDS.cost_type` is not `PARTNER_COST_TYPE_DV360_FEE`. For `PARTNER_COST_TYPE_DV360_FEE` the field will be 0 on read and an automated fee will be applied. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `feeAmount` | `string (https://developers.google.com/discovery/v1/type-format format)` The CPM fee amount in micros of advertiser's currency. Applicable when the `https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#FIELDS.fee_type` is `PARTNER_FEE_TYPE_CPM_FEE`. Must be greater than or equal to 0. For example, for 1.5 standard unit of the advertiser's currency, set this field to 1500000. |
| `feePercentageMillis` | `string (https://developers.google.com/discovery/v1/type-format format)` The media fee percentage in millis (1/1000 of a percent). Applicable when the `https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#FIELDS.fee_type` is `PARTNER_FEE_TYPE_MEDIA_FEE`. Must be greater than or equal to 0. For example: 100 represents 0.1%. |
| End of mutually exclusive fields. ||

## PartnerCostType

Possible types of a partner cost.

| Enums ||
|---|---|
| `PARTNER_COST_TYPE_UNSPECIFIED` | Type value is not specified or is unknown in this version. |
| `PARTNER_COST_TYPE_ADLOOX` | The cost is charged for using Scope3 (previously known as Adloox). Billed by the partner. |
| `PARTNER_COST_TYPE_ADLOOX_PREBID` | The cost is charged for using Scope3 (previously known as Adloox) Pre-Bid. Billed through DV360. |
| `PARTNER_COST_TYPE_ADSAFE` | The cost is charged for using AdSafe. Billed by the partner. |
| `PARTNER_COST_TYPE_ADXPOSE` | The cost is charged for using AdExpose. Billed by the partner. |
| `PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE` | The cost is charged for using Aggregate Knowledge. Billed by the partner. |
| `PARTNER_COST_TYPE_AGENCY_TRADING_DESK` | The cost is charged for using an Agency Trading Desk. Billed by the partner. |
| `PARTNER_COST_TYPE_DV360_FEE` | The cost is charged for using DV360. Billed through DV360. |
| `PARTNER_COST_TYPE_COMSCORE_VCE` | The cost is charged for using comScore vCE. Billed through DV360. |
| `PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM` | The cost is charged for using a Data Management Platform. Billed by the partner. |
| `PARTNER_COST_TYPE_DEFAULT` | The default cost type. Billed by the partner. |
| `PARTNER_COST_TYPE_DOUBLE_VERIFY` | The cost is charged for using DoubleVerify. Billed by the partner. |
| `PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID` | The cost is charged for using DoubleVerify Pre-Bid. Billed through DV360. |
| `PARTNER_COST_TYPE_EVIDON` | The cost is charged for using Evidon. Billed by the partner. |
| `PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO` | The cost is charged for using Integral Ad Science Video. Billed by the partner. |
| `PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID` | The cost is charged for using Integral Ad Science Pre-Bid. Billed through DV360. |
| `PARTNER_COST_TYPE_MEDIA_COST_DATA` | The cost is charged for using media cost data. Billed by the partner. |
| `PARTNER_COST_TYPE_MOAT_VIDEO` | The cost is charged for using MOAT Video. Billed by the partner. |
| `PARTNER_COST_TYPE_NIELSEN_DAR` | The cost is charged for using Nielsen Digital Ad Ratings. Billed through DV360. |
| `PARTNER_COST_TYPE_SHOP_LOCAL` | The cost is charged for using ShopLocal. Billed by the partner. |
| `PARTNER_COST_TYPE_TERACENT` | The cost is charged for using Teracent. Billed by the partner. |
| `PARTNER_COST_TYPE_THIRD_PARTY_AD_SERVER` | The cost is charged for using a third-party ad server. Billed by the partner. |
| `PARTNER_COST_TYPE_TRUST_METRICS` | The cost is charged for using TrustMetrics. Billed by the partner. |
| `PARTNER_COST_TYPE_VIZU` | The cost is charged for using Vizu. Billed by the partner. |
| `PARTNER_COST_TYPE_CUSTOM_FEE_1` | The cost is charged as custom fee 1. Billed by the partner. |
| `PARTNER_COST_TYPE_CUSTOM_FEE_2` | The cost is charged as custom fee 2. Billed by the partner. |
| `PARTNER_COST_TYPE_CUSTOM_FEE_3` | The cost is charged as custom fee 3. Billed by the partner. |
| `PARTNER_COST_TYPE_CUSTOM_FEE_4` | The cost is charged as custom fee 4. Billed by the partner. |
| `PARTNER_COST_TYPE_CUSTOM_FEE_5` | The cost is charged as custom fee 5. Billed by the partner. |
| `PARTNER_COST_TYPE_SCIBIDS_FEE` | The cost is charged for using Scibids. Billed through DV360. This type is currently only available to certain customers. Other customers attempting to use this type will receive an error. |

## PartnerCostFeeType

Possible fee types of a partner cost.

| Enums ||
|---|---|
| `PARTNER_COST_FEE_TYPE_UNSPECIFIED` | Value is not specified or is unknown in this version. |
| `PARTNER_COST_FEE_TYPE_CPM_FEE` | The partner cost is a fixed CPM fee. Not applicable when the partner cost `https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#FIELDS.cost_type` is one of: - `PARTNER_COST_TYPE_MEDIA_COST_DATA` - `PARTNER_COST_TYPE_DV360_FEE`. |
| `PARTNER_COST_FEE_TYPE_MEDIA_FEE` | The partner cost is a percentage surcharge based on the media cost. Not applicable when the partner `https://developers.google.com/display-video/api/reference/rest/v4/PartnerCost#FIELDS.cost_type` is one of: - `PARTNER_COST_TYPE_SHOP_LOCAL` - `PARTNER_COST_TYPE_TRUST_METRICS` - `PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO` - `PARTNER_COST_TYPE_MOAT_VIDEO`. |

## PartnerCostInvoiceType

Possible invoice types of a partner cost.

| Enums ||
|---|---|
| `PARTNER_COST_INVOICE_TYPE_UNSPECIFIED` | Type value is not specified or is unknown in this version. |
| `PARTNER_COST_INVOICE_TYPE_DV360` | Partner cost is billed through DV360. |
| `PARTNER_COST_INVOICE_TYPE_PARTNER` | Partner cost is billed by the partner. |