AI-generated Key Takeaways
-
The Targeting Preset Service in the Ad Manager API allows interaction with Targeting Presets using the v202411 API version.
-
Available operations include creating, retrieving based on a PQL statement, performing actions like deletion, and updating Targeting Preset objects.
-
The service can return numerous errors related to API version, authentication, collection size, common issues, and various specific targeting types such as custom, date/time, daypart, geographical, inventory, and technology.
-
Additional errors cover issues with entity limits, missing features, null or required fields, parsing, permissions, Publisher Query Language context and syntax, quotas, request platform targeting, string format and length, uniqueness constraints, user domain targeting, and video position targeting.
-
An
UNKNOWNerror enumeration is present across error types when the specific error value is not exposed by the API version used.
Service for interacting with Targeting Presets.
- Production WSDL
-
https://ads.google.com/apis/ads/publisher/v202411/TargetingPresetService?wsdl - Namespace
-
https://www.google.com/apis/ads/publisher/v202411 - Operations
- Errors
-
- ApiVersionError
- AuthenticationError
- CollectionSizeError
- CommonError
- CustomTargetingError
- DateTimeRangeTargetingError
- DayPartTargetingError
- EntityChildrenLimitReachedError
- FeatureError
- GenericTargetingError
- GeoTargetingError
- InternalApiError
- InventoryTargetingError
- MobileApplicationTargetingError
- NotNullError
- ParseError
- PermissionError
- PublisherQueryLanguageContextError
- PublisherQueryLanguageSyntaxError
- QuotaError
- RequestPlatformTargetingError
- RequiredCollectionError
- RequiredError
- ServerError
- StatementError
- StringFormatError
- StringLengthError
- TechnologyTargetingError
- UniqueError
- UserDomainTargetingError
- VideoPositionTargetingError
createTargetingPresets
Creates new TargetingPreset objects.
Parameters
| Field | Type | Description |
|---|---|---|
targetingPresets
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
getTargetingPresetsByStatement
Gets a TargetingPresetPage of TargetingPreset objects that satisfy the given Statement.query. The following fields are supported for filtering:
| PQL Property | Object Property |
|---|---|
id
|
TargetingPreset.id |
name
|
TargetingPreset.name |
Parameters
| Field | Type | Description |
|---|---|---|
filterStatement
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
performTargetingPresetAction
Performs actions on the saved targeting objects that match the given filterStatement.
Parameters
| Field | Type | Description |
|---|---|---|
targetingPresetAction
|
|
|
filterStatement
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
updateTargetingPresets
Updates the specified TargetingPreset objects.
Parameters
| Field | Type | Description |
|---|---|---|
targetingPresets
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
Errors
| Error | Reasons |
|---|---|
ApiVersionError
|
Errors related to the usage of API versions.
Enumerations
|
AuthenticationError
|
An error for an exception that occurred when authenticating.
Enumerations
|
CollectionSizeError
|
Error for the size of the collection being too large
Enumerations
|
CommonError
|
A place for common errors that can be used across services.
Enumerations
|
CustomTargetingError
|
Lists all errors related to CustomTargetingKey and
CustomTargetingValue objects.
Enumerations
|
DateTimeRangeTargetingError
|
Lists all date time range errors caused by associating a line item with a targeting
expression.
Enumerations
|
DayPartTargetingError
|
Lists all errors associated with day-part targeting for a line item.
Enumerations
|
EntityChildrenLimitReachedError
|
Lists errors relating to having too many children on an entity.
Enumerations
|
FeatureError
|
Errors related to feature management. If you attempt using a feature that is not available to
the current network you'll receive a FeatureError with the missing feature as the trigger.
Enumerations
|
GenericTargetingError
|
Targeting validation errors that can be used by different targeting types.
Enumerations
|
GeoTargetingError
|
Lists all errors associated with geographical targeting for a
LineItem.
Enumerations
|
InternalApiError
|
Indicates that a server-side error has occured. InternalApiErrors
are generally not the result of an invalid request or message sent by the
client.
Enumerations
|
InventoryTargetingError
|
Lists all inventory errors caused by associating a line item with a targeting
expression.
Enumerations
|
MobileApplicationTargetingError
|
Lists all errors related to mobile application targeting for a line item.
Enumerations
|
NotNullError
|
Caused by supplying a null value for an attribute that cannot be null.
Enumerations
|
ParseError
|
Lists errors related to parsing.
Enumerations
|
PermissionError
|
Errors related to incorrect permission.
Enumerations
|
PublisherQueryLanguageContextError
|
An error that occurs while executing a PQL query contained in
a Statement object.
Enumerations
|
PublisherQueryLanguageSyntaxError
|
An error that occurs while parsing a PQL query contained in a
Statement object.
Enumerations
|
QuotaError
|
Describes a client-side error on which a user is attempting
to perform an action to which they have no quota remaining.
Enumerations
|
RequestPlatformTargetingError
|
Errors related to request platform targeting.
Enumerations
|
RequiredCollectionError
|
A list of all errors to be used for validating sizes of collections.
Enumerations
|
RequiredError
|
Errors due to missing required field.
Enumerations
|
ServerError
|
Errors related to the server.
Enumerations
|
StatementError
|
An error that occurs while parsing Statement objects.
Enumerations
|
StringFormatError
|
A list of error code for reporting invalid content of input strings.
Enumerations
|
StringLengthError
|
Errors for Strings which do not meet given length constraints.
Enumerations
|
TechnologyTargetingError
|
Technology targeting validation errors.
Enumerations
|
UniqueError
|
An error for a field which must satisfy a uniqueness constraint |
UserDomainTargetingError
|
Lists all errors related to user domain targeting for a line item.
Enumerations
|
VideoPositionTargetingError
|
Lists all errors related to VideoPositionTargeting.
Enumerations
|