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\u003eCustomPacingGoal represents a time interval within a CustomPacingCurve, defining pacing targets for ad delivery.\u003c/p\u003e\n"],["\u003cp\u003eEach goal specifies a start time and a target amount, influencing ad delivery until the next goal or the line item's end.\u003c/p\u003e\n"],["\u003cp\u003eThe start time can be explicitly set or inherit from the associated line item's start time.\u003c/p\u003e\n"]]],["The `CustomPacingGoal` defines a pacing interval within a `CustomPacingCurve`, associated with the `ForecastService`. It specifies a `startDateTime` or uses the `LineItem`'s start time via `useLineItemStartDateTime`. Each goal has an `amount`, effective until the next goal's start or the `LineItem`'s end. These goals control the pacing strategy, allowing for adjustments within the forecast service over specific time ranges. The namespace is `https://www.google.com/apis/ads/publisher/v202408`.\n"],null,["# type CustomPacingGoal (v202408)\n\n**Service** \n**ForecastService** [LineItemService](/ad-manager/api/reference/v202408/LineItemService.CustomPacingGoal) **Dependencies** \n[CustomPacingCurve](/ad-manager/api/reference/v202408/ForecastService.CustomPacingCurve) \n▼\n**CustomPacingGoal**\n\nAn interval of a [CustomPacingCurve](/ad-manager/api/reference/v202408/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/v202408`\n\n| Field ----- ||\n|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `startDateTime` | ` `[DateTime](/ad-manager/api/reference/v202408/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/v202408/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 |"]]