type CustomPacingGoal (v202411)
Stay organized with collections
Save and categorize content based on your preferences.
An interval of a CustomPacingCurve. A custom pacing goal contains a start time and an
amount. The goal will apply until either the next custom pacing goal's getStartTime
or
the line item's end time if it is the last goal.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202411
Field
|
startDateTime
|
DateTime
The start date and time of the goal. This field is required unless useLineItemStartDateTime is true.
|
useLineItemStartDateTime
|
xsd:boolean
Whether the LineItem.startDateTime should be used for the start date and time of this
goal. This field is not persisted and if it is set to true, the startDateTime field
will be populated by the line item's start time.
|
amount
|
xsd:long
|
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-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eCustomPacingGoal defines an interval within a CustomPacingCurve, specifying a start time and target amount for pacing.\u003c/p\u003e\n"],["\u003cp\u003eEach goal's pacing applies until the next goal's start time or the line item's end time.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes startDateTime, useLineItemStartDateTime, and amount fields to manage pacing goals within the Google Ad Manager system.\u003c/p\u003e\n"]]],["The `CustomPacingGoal` defines a time-bound objective within a `CustomPacingCurve`, which relies on the `ForecastService` and `LineItemService`. Each goal has a `startDateTime` or uses the `LineItem.startDateTime` if `useLineItemStartDateTime` is true. The goal applies until the subsequent goal's start time or the line item's end. It also has an `amount` field, representing a numerical target to achieve.\n"],null,["# type CustomPacingGoal (v202411)\n\n**Service** \n**ForecastService** [LineItemService](/ad-manager/api/reference/v202411/LineItemService.CustomPacingGoal) **Dependencies** \n[CustomPacingCurve](/ad-manager/api/reference/v202411/ForecastService.CustomPacingCurve) \n▼\n**CustomPacingGoal**\n\nAn interval of a [CustomPacingCurve](/ad-manager/api/reference/v202411/ForecastService.CustomPacingCurve). A custom pacing goal contains a start time and an\namount. The goal will apply until either the next custom pacing goal's `getStartTime` or\nthe line item's end time if it is the last goal.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202411`\n\n| Field ----- ||\n|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `startDateTime` | ` `[DateTime](/ad-manager/api/reference/v202411/ForecastService.DateTime)` ` The start date and time of the goal. This field is required unless `useLineItemStartDateTime` is true. |\n| ### `useLineItemStartDateTime` | ` `xsd:`boolean` Whether the [LineItem.startDateTime](/ad-manager/api/reference/v202411/ForecastService.LineItem#startDateTime) should be used for the start date and time of this goal. This field is not persisted and if it is set to true, the `startDateTime` field will be populated by the line item's start time. |\n| ### `amount` | ` `xsd:`long` \u003cbr /\u003e |"]]