type DateTimeRangeTargetingError (v202411)

AI-generated Key Takeaways

• DateTimeRangeTargetingError is an API error in Google Ad Manager that occurs when associating a line item with a targeting expression, specifically related to date and time ranges.

• This error can arise for various reasons, including empty targeted ranges, unsupported line item reservation types, overlapping ranges, or ranges falling outside the line item's active period.

• The error message provides a reason code, represented by the DateTimeRangeTargetingError.Reason enum, which helps pinpoint the specific issue encountered.

• Developers can use the reason code to troubleshoot and resolve the DateTimeRangeTargetingError, ensuring correct date and time targeting for line items.

• The error's fieldPath and trigger properties offer additional information for debugging and understanding the context of the error within the API request.

Service

AdjustmentService ForecastService LineItemService LineItemTemplateService OrderService ProposalLineItemService TargetingPresetService YieldGroupService

Inheritance

ApiError

▼

ApiVersionError AssetError AudienceExtensionError AudienceSegmentError AuthenticationError ClickTrackingLineItemError CollectionSizeError CommonError CompanyCreditStatusError CreativeError CrossSellError CurrencyCodeError CustomFieldValueError CustomTargetingError DateTimeRangeTargetingError DayPartTargetingError EntityChildrenLimitReachedE... EntityLimitReachedError FeatureError ForecastError FrequencyCapError GenericTargetingError GeoTargetingError GrpSettingsError ImageError InternalApiError InvalidUrlError InventoryTargetingError LabelEntityAssociationError LineItemActivityAssociation... LineItemCreativeAssociation... LineItemError LineItemFlightDateError LineItemOperationError MobileApplicationTargetingE... NotNullError NullError OrderActionError OrderError ParseError PermissionError PrecisionError ProgrammaticError PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RangeError RegExError RequestPlatformTargetingError RequiredCollectionError RequiredError RequiredNumberError RequiredSizeError ReservationDetailsError ServerError SetTopBoxLineItemError StatementError StringFormatError StringLengthError TeamError TechnologyTargetingError TimeZoneError TranscodingError TypeError 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/v202411

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.