type GrpSettingsError (v202411)

  • This documentation details the GrpSettingsError object within the Google Ad Manager API.

  • GrpSettingsError is associated with line items that have GRP (Gross Rating Point) settings configured.

  • The errors encompass issues like invalid age ranges, unsupported line item types or environments for GRP, and problems with Nielsen DAR (Digital Ad Ratings) settings.

  • The reason field provides a specific code indicating the nature of the error, and the documentation links to the Ad Manager Help Center for further information.

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.