AI-generated Key Takeaways
-
The document details various error types in the Ad Manager API's InventoryService, including those related to ad unit refresh rates, sizes, and targeting.
-
Errors can occur due to issues with ad unit codes, multiple target platforms, smart sizing configurations, and adding/updating service ad units.
-
Specific errors are defined for problems with ad unit sizes, such as invalid dimensions, duplicate sizes, and issues with fluid vs.non-fluid sizes.
-
Errors also cover issues with label associations, null or missing required values, parsing problems, and insufficient user permissions.
-
Additional error types include those related to Publisher Query Language syntax and execution, exceeding quota limits, values outside the valid range, incorrect string formatting or length, and issues with team assignments and data types.
Provides operations for creating, updating and retrieving AdUnit objects.
Line items connect a creative with its associated ad unit through targeting.
An ad unit represents a piece of inventory within a publisher. It contains all the settings that need to be associated with the inventory in order to serve ads. For example, the ad unit contains creative size restrictions and AdSense settings.
- Production WSDL
-
https://ads.google.com/apis/ads/publisher/v202502/InventoryService?wsdl - Namespace
-
https://www.google.com/apis/ads/publisher/v202502 - Operations
- Errors
-
- AdSenseAccountError
- AdUnitCodeError
- AdUnitHierarchyError
- ApiVersionError
- AuthenticationError
- CollectionSizeError
- CommonError
- CompanyError
- CreativeWrapperError
- CrossSellError
- EntityChildrenLimitReachedError
- EntityLimitReachedError
- FeatureError
- FrequencyCapError
- InternalApiError
- InvalidColorError
- InvalidUrlError
- InventoryUnitError
- InventoryUnitRefreshRateError
- InventoryUnitSizesError
- LabelEntityAssociationError
- NotNullError
- NullError
- ParseError
- PermissionError
- PublisherQueryLanguageContextError
- PublisherQueryLanguageSyntaxError
- QuotaError
- RangeError
- RegExError
- RequiredCollectionError
- RequiredError
- RequiredNumberError
- ServerError
- StatementError
- StringFormatError
- StringLengthError
- TeamError
- TypeError
- UniqueError
createAdUnits
Creates new AdUnit objects.
Parameters
| Field | Type | Description |
|---|---|---|
adUnits
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
getAdUnitSizesByStatement
Returns a set of all relevant AdUnitSize objects.
The given Statement is currently ignored but may be honored in future versions.
Parameters
| Field | Type | Description |
|---|---|---|
filterStatement
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
getAdUnitsByStatement
Gets a AdUnitPage of AdUnit objects that satisfy the given Statement.query. The following fields are supported for filtering:
| PQL Property | Object Property |
|---|---|
adUnitCode
|
AdUnit.adUnitCode |
id
|
AdUnit.id |
name
|
AdUnit.name |
parentId
|
AdUnit.parentId |
status
|
AdUnit.status |
lastModifiedDateTime
|
AdUnit.lastModifiedDateTime |
Parameters
| Field | Type | Description |
|---|---|---|
filterStatement
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
performAdUnitAction
Performs actions on AdUnit objects that match the given Statement.query.
Parameters
| Field | Type | Description |
|---|---|---|
adUnitAction
|
|
|
filterStatement
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
updateAdUnits
Updates the specified AdUnit objects.
Parameters
| Field | Type | Description |
|---|---|---|
adUnits
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
Errors
| Error | Reasons |
|---|---|
AdSenseAccountError
|
Error for AdSense related API calls.
Enumerations
|
AdUnitCodeError
|
Lists the generic errors associated with AdUnit.adUnitCode.
Enumerations
|
AdUnitHierarchyError
|
Caused by creating an AdUnit object with an invalid hierarchy.
Enumerations
|
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
|
CompanyError
|
A list of all errors associated with companies.
Enumerations
|
CreativeWrapperError
|
Errors specific to creative wrappers.
Enumerations
|
CrossSellError
|
Lists all errors associated with cross selling.
Enumerations
|
EntityChildrenLimitReachedError
|
Lists errors relating to having too many children on an entity.
Enumerations
|
EntityLimitReachedError
|
An error that occurs when creating an entity if the limit on the number of allowed entities for
a network has already been reached.
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
|
FrequencyCapError
|
Lists all errors associated with frequency caps.
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
|
InvalidColorError
|
A list of all errors associated with a color attribute.
Enumerations
|
InvalidUrlError
|
Lists all errors associated with URLs.
Enumerations
|
InventoryUnitError
|
Lists the generic errors associated with AdUnit objects.
Enumerations
|
InventoryUnitRefreshRateError
|
Lists errors relating to AdUnit.refreshRate.
Enumerations
|
InventoryUnitSizesError
|
An error specifically for InventoryUnitSizes.
Enumerations
|
LabelEntityAssociationError
|
Errors specific to creating label entity associations.
Enumerations
|
NotNullError
|
Caused by supplying a null value for an attribute that cannot be null.
Enumerations
|
NullError
|
Errors associated with violation of a NOT NULL check.
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
|
RangeError
|
A list of all errors associated with the Range constraint.
Enumerations
|
RegExError
|
Caused by supplying a value for an object attribute that does not conform
to a documented valid regular expression.
Enumerations
|
RequiredCollectionError
|
A list of all errors to be used for validating sizes of collections.
Enumerations
|
RequiredError
|
Errors due to missing required field.
Enumerations
|
RequiredNumberError
|
A list of all errors to be used in conjunction with required number
validators.
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
|
TeamError
|
Errors related to a Team.
Enumerations
|
TypeError
|
An error for a field which is an invalid type. |
UniqueError
|
An error for a field which must satisfy a uniqueness constraint |