type GrpSettingsError (v202505)

AI-generated Key Takeaways

• 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.