type GrpSettingsError (v202505)

  • GrpSettingsError represents errors related to line items with GRP settings within the Ad Manager API.

  • This error inherits from ApiError, providing common fields for identifying the error cause such as fieldPath, fieldPathElements, trigger, and errorString.

  • The GrpSettingsError includes a 'reason' field, which uses an enumeration to specify various causes for the error, such as invalid age ranges, unsupported line item types, or issues with Nielsen integration.

  • GRP settings are primarily supported for video line items, and certain configurations like age ranges and gender specifications have specific validity rules.

  • Once a line item with GRP settings starts serving, certain attributes like the GRP provider and settings cannot be changed.
Service
ForecastService LineItemService LineItemTemplateService OrderService ProposalLineItemService
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

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.