type GrpSettingsError (v202505)

  • GrpSettingsError is associated with errors related to line items that have GRP settings configured.

  • This error inherits from ApiError and includes details like the field path, trigger, and a string representation of the error.

  • The reason field provides specific error reasons using an enum, such as invalid age ranges, unsupported line item types, or issues with Nielsen registration.

  • GRP settings are primarily supported for video line items and have restrictions on age ranges and gender specification for audience targeting.

  • Certain GRP settings and goals cannot be changed or removed once the line item begins serving.
Service
ForecastService LineItemService LineItemTemplateService OrderService ProposalLineItemService
Inheritance
ApiError
▼
ApiVersionError AudienceSegmentError AuthenticationError BillingError CollectionSizeError CommonError CurrencyCodeError CustomFieldValueError CustomTargetingError DateTimeRangeTargetingError DayPartTargetingError DealError EntityChildrenLimitReachedE... EntityLimitReachedError ExchangeRateError FeatureError ForecastError FrequencyCapError GenericTargetingError GeoTargetingError GrpSettingsError InternalApiError InventoryTargetingError LabelEntityAssociationError LineItemError LineItemFlightDateError LineItemOperationError MobileApplicationTargetingE... NotNullError ParseError PermissionError PrecisionError PreferredDealError ProgrammaticError ProposalActionError ProposalError ProposalLineItemActionError ProposalLineItemError ProposalLineItemMakegoodError ProposalLineItemProgrammati... PublisherQueryLanguageConte... PublisherQueryLanguageSynta... QuotaError RangeError RequestPlatformTargetingError RequiredCollectionError RequiredError RequiredNumberError ReservationDetailsError ServerError StatementError StringFormatError StringLengthError TeamError TechnologyTargetingError TimeZoneError TypeError UniqueError UserDomainTargetingError VideoPositionTargetingError

Errors associated with line items with GRP settings.

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

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.

GrpSettingsError

reason

GrpSettingsError.Reason

The error reason represented by an enum.

Enumerations
INVALID_AGE_RANGE
Age range for GRP audience is not valid. Please see the Ad Manager Help Center for more information.
UNDER_18_MIN_AGE_REQUIRES_ALL_AGES
Age range for GRP audience is not allowed to include ages under 18 unless designating all ages in target(2-65+).
LINE_ITEM_ENVIRONMENT_TYPE_NOT_SUPPORTED
GRP settings are only supported for video line items.
NIELSEN_DAR_REQUIRES_INSTREAM_VIDEO
For deals with Nielsen DAR enabled, there must be an instream video environment.
LINE_ITEM_TYPE_NOT_SUPPORTED
GRP settings are not supported for the given line item type.
CANNOT_SPECIFY_GENDER_FOR_GIVEN_AGE_RANGE
GRP audience gender cannot be specified for the selected age range.
INVALID_MIN_AGE
Minimum age for GRP audience is not valid.
INVALID_MAX_AGE
Maximum age for GRP audience is not valid.
CANNOT_DISABLE_GRP_AFTER_ENABLING
GRP settings cannot be disabled.
CANNOT_CHANGE_GRP_PROVIDERS
GRP provider cannot be updated.
CANNOT_CHANGE_GRP_SETTINGS
GRP settings cannot be updated once the line item has started serving.
GRP_AUDIENCE_GOAL_NOT_SUPPORTED
Impression goal based on GRP audience is not supported.
DEMOG_GOAL_EXPECTED
Impression goal based on GRP audience expected.
CANNOT_SET_GRP_AUDIENCE_GOAL
Impression goal based on GRP audience cannot be set once the line item has started serving.
CANNOT_REMOVE_GRP_AUDIENCE_GOAL
Impression goal based on GRP audience cannot be removed once the line item has started serving.
UNSUPPORTED_GEO_TARGETING
Unsupported geographic location targeted for line item with GRP audience goal.
UNSUPPORTED_GRP_SETTING
GRP Settings specified are unsupported.
SHOULD_SET_IN_TARGET_GOAL_THROUGH_GRP_SETTINGS
In-target line items should be set through the grpSettings target impression goal.
SHOULD_SET_IN_TARGET_GOAL_THROUGH_PRIMARY_GOAL
In-target line items should be set through the primaryReservationUnit's in-target Impressions unit type.
NIELSEN_REGISTRATION_FAILED
Attempt to register with Nielsen failed.
LEGACY_NIELSEN_CAMPAIGN_REGISTRATION_ATTEMPT
Attempted to register a placement on a legacy Nielsen campaign.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.