type DateTimeRangeTargetingError (v202502)

  • The DateTimeRangeTargetingError lists errors related to associating line items with a targeting expression based on date and time ranges.

  • This error type is relevant to several services including AdjustmentService, ForecastService, LineItemService, LineItemTemplateService, OrderService, ProposalLineItemService, TargetingPresetService, and YieldGroupService.

  • DateTimeRangeTargetingError inherits from ApiError and includes fields such as fieldPath, fieldPathElements, trigger, and errorString for identifying the cause of the error.

  • Specific reasons for this error are enumerated, covering issues like empty ranges, line item type restrictions, overlapping ranges, and time mismatches with line item settings.

  • The error reason is represented by an enum with various values indicating the exact nature of the date time range targeting problem.
Service
AdjustmentService ForecastService LineItemService LineItemTemplateService OrderService ProposalLineItemService TargetingPresetService YieldGroupService
Inheritance
ApiError
▼
ApiVersionError AuthenticationError CollectionSizeError CommonError CustomTargetingError DateTimeRangeTargetingError DayPartTargetingError EntityChildrenLimitReachedE... EntityLimitReachedError FeatureError GenericTargetingError GeoTargetingError InternalApiError InventoryTargetingError MobileApplicationTargetingE... NotNullError ParseError PermissionError PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RequestPlatformTargetingError RequiredCollectionError RequiredError ServerError StatementError StringFormatError StringLengthError TechnologyTargetingError UniqueError UserDomainTargetingError VideoPositionTargetingError

Lists all date time range errors caused by associating a line item with a targeting expression.

Namespace
https://www.google.com/apis/ads/publisher/v202502

Field
ApiError (inherited)

fieldPath

xsd:string

The OGNL field path to identify cause of error.

fieldPathElements

FieldPathElement[]

A parsed copy of the field path. For example, the field path "operations[1].operand" corresponds to this list: {FieldPathElement(field = "operations", index = 1), FieldPathElement(field = "operand", index = null)}.

trigger

xsd:string

The data that caused the error.

errorString

xsd:string

A simple string representation of the error and reason.

DateTimeRangeTargetingError

reason

DateTimeRangeTargetingError...

The error reason represented by an enum.

Enumerations
EMPTY_RANGES
No targeted ranges exists.
NOT_SPONSORSHIP_LINEITEM
Type of lineitem is not sponsorship.
NOT_SPONSORSHIP_OR_STANDARD_LINEITEM
Type of lineitem is not sponsorship or standard.
UNSUPPORTED_LINEITEM_RESERVATION_TYPE
Line item must have a reservation type of sponsorship, standard or preferred deal to use date time range targeting.
PAST_RANGES_CHANGED
Past ranges are changed.
RANGES_OVERLAP
Targeted date time ranges overlap.
FIRST_DATE_TIME_DOES_NOT_MATCH_START_TIME
First date time does not match line item's start time.
LAST_DATE_TIME_DOES_NOT_MATCH_END_TIME
Last date time does not match line item's end time.
RANGES_OUT_OF_LINEITEM_ACTIVE_PERIOD
Targeted date time ranges fall out the active period of lineitem.
START_TIME_IS_NOT_START_OF_DAY
Start time of range (except the earliest range) is not at start of day. Start of day is 00:00:00.
END_TIME_IS_NOT_END_OF_DAY
End time of range (except the latest range) is not at end of day. End of day is 23:59:59.
START_DATE_TIME_IS_IN_PAST
Start date time of earliest targeted ranges is in past.
MODIFY_START_DATE_TIME_TO_PAST
Cannot modify the start date time for date time targeting to the past.
RANGE_END_TIME_BEFORE_START_TIME
The end time of range is before the start time. Could happen when start type is IMMEDIATE or ONE_HOUR_LATER.
END_DATE_TIME_IS_TOO_LATE
End date time of latest targeted ranges is too late.
LIMITED_RANGES_IN_UNLIMITED_LINEITEM
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.