type GrpSettingsError (v202411)

  • GrpSettingsError represents errors related to line items with GRP settings and inherits from ApiError.

  • The GrpSettingsError includes a reason field which is an enum detailing various specific errors such as invalid age ranges, unsupported environments, and issues with Nielsen integration.

  • Common errors inherited from ApiError include fields for identifying the cause of the error via field path and providing a simple string representation of the error.

  • GRP settings have restrictions on age ranges, line item types (only video), and cannot be disabled or changed once the line item has started serving.

  • Attempting to set or remove a GRP audience goal after a line item starts serving is not allowed.
Service
ForecastService LineItemService LineItemTemplateService OrderService ProposalLineItemService
Inheritance
ApiError
▼
AdUnitCodeError ApiVersionError AssetError AudienceExtensionError AudienceSegmentError AuthenticationError ClickTrackingLineItemError CollectionSizeError CommonError CompanyCreditStatusError CreativeError CrossSellError CurrencyCodeError CustomFieldValueError CustomTargetingError DateError DateTimeRangeTargetingError DayPartTargetingError EntityChildrenLimitReachedE... EntityLimitReachedError FeatureError ForecastError FrequencyCapError GenericTargetingError GeoTargetingError GrpSettingsError ImageError InternalApiError InvalidUrlError InventoryTargetingError InventoryUnitError 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

Errors associated with line items with GRP settings.

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.

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.