PricingSchedule
Stay organized with collections
Save and categorize content based on your preferences.
| Fields |
testingStartDate |
string
Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
|
startDate |
string
Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion.
|
endDate |
string
Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion.
|
pricingType |
enum (PlacementPricingType)
Placement pricing type. This field is required on insertion.
|
capCostOption |
enum (PlacementCapCostOption)
Placement cap cost option.
|
flighted |
boolean
Whether this placement is flighted. If true, pricing periods will be computed automatically.
|
pricingPeriods[] |
object (PricingSchedulePricingPeriod)
Pricing periods for this placement.
|
floodlightActivityId |
string (int64 format)
Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to
PRICING_TYPE_CPA
.
|
PricingSchedulePricingPeriod
| JSON representation |
{
"startDate": string,
"endDate": string,
"units": string,
"rateOrCostNanos": string,
"pricingComment": string
} |
| Fields |
startDate |
string
Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error.
|
endDate |
string
Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error.
|
units |
string (int64 format)
Units of this pricing period. Acceptable values are
0
to
10000000000
, inclusive.
|
rateOrCostNanos |
string (int64 format)
Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are
0
to
1000000000000000000
, inclusive.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-02 UTC.
[null,null,["Last updated 2025-09-02 UTC."],[[["\u003cp\u003eA pricing schedule defines the cost and timeframe for ad placements, including start and end dates, pricing type, and optional cap costs.\u003c/p\u003e\n"],["\u003cp\u003ePricing can be based on various models, such as CPM, CPC, CPA, or flat rates for impressions or clicks.\u003c/p\u003e\n"],["\u003cp\u003ePricing periods allow for setting specific costs and unit amounts within the overall placement schedule.\u003c/p\u003e\n"],["\u003cp\u003eCap cost options can be set to none, monthly, or cumulative to control spending limits.\u003c/p\u003e\n"],["\u003cp\u003eFloodlight activity IDs can be associated with placements for CPA pricing to track conversions.\u003c/p\u003e\n"]]],[],null,["- [JSON representation](#SCHEMA_REPRESENTATION)\n- [PricingSchedulePricingPeriod](#PricingSchedulePricingPeriod)\n - [JSON representation](#PricingSchedulePricingPeriod.SCHEMA_REPRESENTATION)\n\nPricing Schedule\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"testingStartDate\": string, \"startDate\": string, \"endDate\": string, \"pricingType\": enum (/doubleclick-advertisers/rest/Shared.Types/PlacementPricingType), \"capCostOption\": enum (/doubleclick-advertisers/rest/Shared.Types/PlacementCapCostOption), \"flighted\": boolean, \"pricingPeriods\": [ { object (/doubleclick-advertisers/rest/v4/PricingSchedule#PricingSchedulePricingPeriod) } ], \"floodlightActivityId\": string } ``` |\n\n| Fields ||\n|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `testingStartDate` | `string` Testing start date of this placement. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. |\n| `startDate` | `string` Placement start date. This date must be later than, or the same day as, the campaign start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. This field is required on insertion. |\n| `endDate` | `string` Placement end date. This date must be later than, or the same day as, the placement start date, but not later than the campaign end date. If, for example, you set 6/25/2015 as both the start and end dates, the effective placement date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. This field is required on insertion. |\n| `pricingType` | `enum (`[PlacementPricingType](/doubleclick-advertisers/rest/Shared.Types/PlacementPricingType)`)` Placement pricing type. This field is required on insertion. |\n| `capCostOption` | `enum (`[PlacementCapCostOption](/doubleclick-advertisers/rest/Shared.Types/PlacementCapCostOption)`)` Placement cap cost option. |\n| `flighted` | `boolean` Whether this placement is flighted. If true, pricing periods will be computed automatically. |\n| `pricingPeriods[]` | `object (`[PricingSchedulePricingPeriod](/doubleclick-advertisers/rest/v4/PricingSchedule#PricingSchedulePricingPeriod)`)` Pricing periods for this placement. |\n| `floodlightActivityId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Floodlight activity ID associated with this placement. This field should be set when placement pricing type is set to `PRICING_TYPE_CPA` . |\n\nPricingSchedulePricingPeriod Pricing Period\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"startDate\": string, \"endDate\": string, \"units\": string, \"rateOrCostNanos\": string, \"pricingComment\": string } ``` |\n\n| Fields ||\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `startDate` | `string` Pricing period start date. This date must be later than, or the same day as, the placement start date. The hours, minutes, and seconds of the start date should not be set, as doing so will result in an error. |\n| `endDate` | `string` Pricing period end date. This date must be later than, or the same day as, the pricing period start date, but not later than the placement end date. The period end date can be the same date as the period start date. If, for example, you set 6/25/2015 as both the start and end dates, the effective pricing period date is just that day only, 6/25/2015. The hours, minutes, and seconds of the end date should not be set, as doing so will result in an error. |\n| `units` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Units of this pricing period. Acceptable values are `0` to `10000000000` , inclusive. |\n| `rateOrCostNanos` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Rate or cost of this pricing period in nanos (i.e., multiplied by 1000000000). Acceptable values are `0` to `1000000000000000000` , inclusive. |\n| `pricingComment` | `string` Comments for this pricing period. |"]]
