type CustomPacingGoal (v202408)
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/v202408
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\u003eA CustomPacingGoal defines a segment within a CustomPacingCurve, specifying a target delivery amount within a specific timeframe for a line item.\u003c/p\u003e\n"],["\u003cp\u003eEach goal's timeframe starts at its \u003ccode\u003estartDateTime\u003c/code\u003e and extends until the next goal's start time or the line item's end, with the \u003ccode\u003eamount\u003c/code\u003e representing the target delivery within that period.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003estartDateTime\u003c/code\u003e can either be explicitly set or inherit from the associated line item's start time using the \u003ccode\u003euseLineItemStartDateTime\u003c/code\u003e flag.\u003c/p\u003e\n"]]],["The `CustomPacingGoal` defines a time-bound interval within a `CustomPacingCurve`. It contains a `startDateTime` or utilizes the `LineItem.startDateTime`, and a numerical `amount`. This goal's effect lasts until the subsequent goal's start time or the line item's end time if it is last in the sequence. The `useLineItemStartDateTime` boolean determines if the line item's start date and time is used for this pacing goal.\n"],null,["# type CustomPacingGoal (v202408)\n\n**Service** \n[ForecastService](/ad-manager/api/reference/v202408/ForecastService.CustomPacingGoal) **LineItemService** **Dependencies** \n[CustomPacingCurve](/ad-manager/api/reference/v202408/LineItemService.CustomPacingCurve) \n▼\n**CustomPacingGoal**\n\nAn interval of a [CustomPacingCurve](/ad-manager/api/reference/v202408/LineItemService.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/v202408`\n\n| Field ----- ||\n|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `startDateTime` | ` `[DateTime](/ad-manager/api/reference/v202408/LineItemService.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/v202408/LineItemService.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 |"]]