Provides methods for adding, updating and retrieving Proposal objects.
- Production WSDL
-
https://ads.google.com/apis/ads/publisher/v202511/ProposalService?wsdl - Namespace
-
https://www.google.com/apis/ads/publisher/v202511 - Operations
- Errors
-
- ApiVersionError
- AudienceSegmentError
- AuthenticationError
- BillingError
- CollectionSizeError
- CommonError
- CurrencyCodeError
- CustomFieldValueError
- DealError
- EntityChildrenLimitReachedError
- EntityLimitReachedError
- ExchangeRateError
- FeatureError
- ForecastError
- InternalApiError
- InvalidUrlError
- LabelEntityAssociationError
- LineItemOperationError
- NotNullError
- NullError
- ParseError
- PermissionError
- PrecisionError
- ProgrammaticError
- ProposalActionError
- ProposalError
- ProposalLineItemError
- ProposalLineItemMakegoodError
- ProposalLineItemProgrammaticError
- PublisherQueryLanguageContextError
- PublisherQueryLanguageSyntaxError
- QuotaError
- RangeError
- RequiredCollectionError
- RequiredError
- RequiredNumberError
- ServerError
- StatementError
- StringFormatError
- StringLengthError
- TeamError
- TimeZoneError
- TypeError
- UniqueError
createProposals
Creates new Proposal objects.
For each proposal, the following fields are required:
Parameters
| Field | Type | Description |
|---|---|---|
proposals
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
getMarketplaceCommentsByStatement
Gets a MarketplaceCommentPage of MarketplaceComment objects that satisfy the given Statement.query . This method only returns comments already sent to Marketplace, local draft ProposalMarketplaceInfo.marketplaceComment are not included. The following fields are supported for filtering:
| PQL Property | Object Property |
|---|---|
proposalId
|
MarketplaceComment.proposalId |
proposalId
, and only supports a subset of PQL
syntax:[WHERE <condition> {AND <condition>
...}]
[ORDER BY <property> [ASC | DESC]]
[LIMIT {[<offset>,] <count>} | {<count>
OFFSET <offset>}]
<condition>
:= <property> = <value>
<condition> := <property> IN
<list>
Only supports ORDER BY
MarketplaceComment.creationTime
.
Parameters
| Field | Type | Description |
|---|---|---|
filterStatement
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
getProposalsByStatement
Gets a ProposalPage of Proposal objects that satisfy the given Statement.query . The following fields are supported for filtering:
| PQL Property | Object Property |
|---|---|
id
|
Proposal.id |
dfpOrderId
|
Proposal.dfpOrderId |
name
|
Proposal.name |
status
|
Proposal.status |
isArchived
|
Proposal.isArchived |
approvalStatus
Only applicable for proposals using sales management
|
Proposal.approvalStatus |
lastModifiedDateTime
|
Proposal.lastModifiedDateTime |
isProgrammatic
|
Proposal.isProgrammatic |
negotiationStatus
Only applicable for programmatic proposals
|
ProposalMarketplaceInfo.negotiationStatus |
Parameters
| Field | Type | Description |
|---|---|---|
filterStatement
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
performProposalAction
Performs actions on Proposal objects that match the given Statement.query .
The following fields are also required when submitting proposals for approval:
Parameters
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
updateProposals
Updates the specified Proposal objects.
Parameters
| Field | Type | Description |
|---|---|---|
proposals
|
|
Response
| Field | Type | Description |
|---|---|---|
rval
|
|
Errors
Enumerations
-
UPDATE_TO_NEWER_VERSION - Indicates that the operation is not allowed in the version the request was made in.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
FIRST_PARTY_AUDIENCE_SEGMENT_NOT_SUPPORTED - First party audience segment is not supported.
-
ONLY_RULE_BASED_FIRST_PARTY_AUDIENCE_SEGMENTS_CAN_BE_CREATED - Only rule-based first-party audience segments can be created.
-
AUDIENCE_SEGMENT_ID_NOT_FOUND - Audience segment for the given id is not found.
-
INVALID_AUDIENCE_SEGMENT_RULE - Audience segment rule is invalid.
-
AUDIENCE_SEGMENT_RULE_TOO_LONG - Audience segment rule contains too many ad units and/or custom criteria.
-
INVALID_AUDIENCE_SEGMENT_NAME - Audience segment name is invalid.
-
DUPLICATE_AUDIENCE_SEGMENT_NAME - Audience segment with this name already exists.
-
INVALID_AUDIENCE_SEGMENT_DESCRIPTION - Audience segment description is invalid.
-
INVALID_AUDIENCE_SEGMENT_PAGEVIEWS - Audience segment pageviews value is invalid. It must be between 1 and 12.
-
INVALID_AUDIENCE_SEGMENT_RECENCY - Audience segment recency value is invalid. It must be between 1 and 90 if pageviews > 1.
-
INVALID_AUDIENCE_SEGMENT_MEMBERSHIP_EXPIRATION - Audience segment membership expiration value is invalid. It must be between 1 and 180.
-
INVALID_AUDIENCE_SEGMENT_CUSTOM_KEY_NAME - The given custom key cannot be part of audience segment rule due to unsupported characters.
-
INVALID_AUDIENCE_SEGMENT_CUSTOM_VALUE_NAME - The given custom value cannot be part of audience segment rule due to unsupported characters.
-
INVALID_AUDIENCE_SEGMENT_CUSTOM_VALUE_MATCH_TYPE - Broad-match custom value cannot be part of audience segment rule.
-
INVALID_NESTED_FIRST_PARTY_AUDIENCE_SEGMENT - Audience segment rule cannot contain itself.
-
SHARED_SELLING_PARTNER_ROOT_CANNOT_BE_INCLUDED - Audience segment rule cannot contain shared selling inventory unit.
-
INVALID_NESTED_THIRD_PARTY_AUDIENCE_SEGMENT - Audience segment rule cannot contain a nested third-party segment.
-
INACTIVE_NESTED_AUDIENCE_SEGMENT - Audience segment rule cannot contain a nested inactive segment.
-
AUDIENCE_SEGMENT_GLOBAL_LICENSE_ERROR - An error occurred when purchasing global licenses.
-
SEGMENT_VIOLATED_POLICY - Segment cannot be activated as it violates Google's Platform Policy.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
AMBIGUOUS_SOAP_REQUEST_HEADER - The SOAP message contains a request header with an ambiguous definition of the authentication
header fields. This means either the
authTokenandoAuthTokenfields were both null or both were specified. Exactly one value should be specified with each request. -
INVALID_EMAIL - The login provided is invalid.
-
AUTHENTICATION_FAILED - Tried to authenticate with provided information, but failed.
-
INVALID_OAUTH_SIGNATURE - The OAuth provided is invalid.
-
INVALID_SERVICE - The specified service to use was not recognized.
-
MISSING_SOAP_REQUEST_HEADER - The SOAP message is missing a request header with an
authTokenand optionalnetworkCode. -
MISSING_AUTHENTICATION_HTTP_HEADER - The HTTP request is missing a request header with an
authToken -
MISSING_AUTHENTICATION - The request is missing an
authToken -
NETWORK_API_ACCESS_DISABLED - The network does not have API access enabled.
-
NO_NETWORKS_TO_ACCESS - The user is not associated with any network.
-
NETWORK_NOT_FOUND - No network for the given
networkCodewas found. -
NETWORK_CODE_REQUIRED - The user has access to more than one network, but did not provide a
networkCode. -
CONNECTION_ERROR - An error happened on the server side during connection to authentication service.
-
GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK - The user tried to create a test network using an account that already is associated with a network.
-
UNDER_INVESTIGATION - The account is blocked and under investigation by the collections team. Please contact Google for more information.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
UNSUPPORTED_BILLING_SCHEDULE - Found unsupported billing schedule.
-
UNSUPPORTED_BILLING_CAP - Found unsupported billing cap.
-
MISSING_BILLING_SOURCE - Billing source is missing when either billing scheule or billing cap is provided.
-
MISSING_BILLING_SCHEDULE - Billing schedule is missing when the provided billing source is CONSTRACTED.
-
MISSING_BILLING_CAP - Billing cap is missing when the provided billing source is not CONSTRACTED.
-
INVALID_BILLING_SOURCE_FOR_OFFLINE - The billing source is invalid for offline proposal line item.
-
UPDATE_BILLING_NOT_ALLOWED - Billing settings cannot be updated once the proposal has been approved.
-
MISSING_BILLING_BASE - Billing base is missing when the provided billing source is CONTRACTED.
-
INVALID_BILLING_BASE - The billing base is invalid for the provided billing source.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
TOO_LARGE -
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
NOT_FOUND - Indicates that an attempt was made to retrieve an entity that does not exist.
-
ALREADY_EXISTS - Indicates that an attempt was made to create an entity that already exists.
-
NOT_APPLICABLE - Indicates that a value is not applicable for given use case.
-
DUPLICATE_OBJECT - Indicates that two elements in the collection were identical.
-
CANNOT_UPDATE - Indicates that an attempt was made to change an immutable field.
-
UNSUPPORTED_OPERATION - Indicates that the requested operation is not supported.
-
CONCURRENT_MODIFICATION - Indicates that another request attempted to update the same data in the same network at about the same time. Please wait and try the request again.
-
REQUEST_TOO_LARGE - Indicates that the request is too large to be processed.
This error is thrown when internal system limits are exceeded due to the number of affected entities implied by the input parameters. Clients should reduce the number of affected entities and try again.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
INVALID - The currency code is invalid and does not follow ISO 4217.
-
UNSUPPORTED - The currency code is valid, but is not supported.
-
DEPRECATED_CURRENCY_USED - The currency has been used for entity creation after its deprecation
Enumerations
-
CUSTOM_FIELD_NOT_FOUND - An attempt was made to modify or create a CustomFieldValue for a CustomField that does not exist.
-
CUSTOM_FIELD_INACTIVE - An attempt was made to create a new value for a custom field that is inactive.
-
CUSTOM_FIELD_OPTION_NOT_FOUND - An attempt was made to modify or create a CustomFieldValue corresponding to a CustomFieldOption that could not be found.
-
INVALID_ENTITY_TYPE - An attempt was made to modify or create a CustomFieldValue with an association to an entity of the wrong type for its field.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
CANNOT_ADD_LINE_ITEM_WHEN_SOLD - Cannot add new proposal line items
to a Proposal
when Proposal.isSold
is
true. -
CANNOT_ARCHIVE_LINE_ITEM_WHEN_SOLD - Cannot archive proposal line items
from a Proposal
when Proposal.isSold
is
true. -
CANNOT_ARCHIVE_PROPOSAL_WHEN_SOLD - Cannot archive a Proposal
when Proposal.isSold
is
true. -
CANNOT_CHANGE_FIELD_REQUIRING_BUYER_APPROVAL - Cannot change a field that requires buyer approval during the current operation.
-
CANNOT_GET_SELLER_ID - Cannot find seller ID for the Proposal .
-
CAN_ONLY_EXECUTE_IF_LOCAL_EDITS - Proposal must be marked as editable by EditProposalsForNegotiation before performing requested action.
-
MISSING_PROPOSAL_LINE_ITEMS - Proposal contains no proposal line items .
-
MISSING_ENVIRONMENT - No environment set for Proposal .
-
MISSING_AD_EXCHANGE_PROPERTY - The Ad Exchange property is not associated with the current network.
-
CANNOT_FIND_PROPOSAL_IN_MARKETPLACE - Cannot find Proposal in Marketplace.
-
CANNOT_GET_PRODUCT - No
Productexists for buyer-initiated programmatic proposals . -
NEW_VERSION_FROM_BUYER - A new version of the Proposal was sent from buyer, cannot execute the requested action before performing DiscardLocalVersionEdits .
-
PROPOSAL_OUT_OF_SYNC_WITH_MARKETPLACE - A new version of the Proposal exists in Marketplace, cannot execute the requested action before the proposal is synced to newest revision.
-
NO_PROPOSAL_CHANGES_FOUND - No Proposal changes were found.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
LINE_ITEM_LIMIT_FOR_ORDER_REACHED - The number of line items on the order exceeds the max number of line items allowed per order in the network.
-
CREATIVE_ASSOCIATION_LIMIT_FOR_LINE_ITEM_REACHED - The number of creatives associated with the line item exceeds the max number of creatives allowed to be associated with a line item in the network.
-
AD_UNIT_LIMIT_FOR_PLACEMENT_REACHED - The number of ad units on the placement exceeds the max number of ad units allowed per placement in the network.
-
TARGETING_EXPRESSION_LIMIT_FOR_LINE_ITEM_REACHED - The number of targeting expressions on the line item exceeds the max number of targeting expressions allowed per line item in the network.
-
TARGETING_EXPRESSION_SIZE_LIMIT_REACHED - The size of a single targeting expression tree exceeds the max size allowed by the network.
-
CUSTOM_TARGETING_VALUES_FOR_KEY_LIMIT_REACHED - The number of custom targeting values for the free-form or predefined custom targeting key exceeds the max number allowed.
-
TARGETING_EXPRESSION_LIMIT_FOR_CREATIVES_ON_LINE_ITEM_REACHED - The total number of targeting expressions on the creatives for the line item exceeds the max number allowed per line item in the network.
-
ATTACHMENT_LIMIT_FOR_PROPOSAL_REACHED - The number of attachments added to the proposal exceeds the max number allowed per proposal in the network.
-
PROPOSAL_LINE_ITEM_LIMIT_FOR_PROPOSAL_REACHED - The number of proposal line items on the proposal exceeds the max number allowed per proposal in the network.
-
PRODUCT_LIMIT_FOR_PRODUCT_PACKAGE_REACHED - The number of product package items on the product package exceeds the max number allowed per product package in the network.
-
PRODUCT_TEMPLATE_AND_PRODUCT_BASE_RATE_LIMIT_FOR_RATE_CARD_REACHED - The number of product template and product base rates on the rate card (including excluded product base rates) exceeds the max number allowed per rate card in the network.
-
PRODUCT_PACKAGE_ITEM_BASE_RATE_LIMIT_FOR_RATE_CARD_REACHED - The number of product package item base rates on the rate card exceeds the max number allowed per rate card in the network.
-
PREMIUM_LIMIT_FOR_RATE_CARD_REACHED - The number of premiums of the rate card exceeds the max number allowed per rate card in the network.
-
AD_UNIT_LIMIT_FOR_AD_EXCLUSION_RULE_TARGETING_REACHED - The number of ad units on
AdExclusionRule.inventoryTargetingexceeds the max number of ad units allowed per ad exclusion rule inventory targeting in the network. -
NATIVE_STYLE_LIMIT_FOR_NATIVE_AD_FORMAT_REACHED - The number of native styles under the native creative template exceeds the max number of native styles allowed per native creative template in the network.
-
TARGETING_EXPRESSION_LIMIT_FOR_PRESENTATION_ASSIGNMENT_REACHED - The number of targeting expressions on the native style exceeds the max number of targeting expressions allowed per native style in the network.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
CUSTOM_TARGETING_VALUES_LIMIT_REACHED - The number of custom targeting values exceeds the max number allowed in the network.
-
AD_EXCLUSION_RULES_LIMIT_REACHED - The number of ad exclusion rules exceeds the max number allowed in the network.
-
FIRST_PARTY_AUDIENCE_SEGMENTS_LIMIT_REACHED - The number of first party audience segments exceeds the max number allowed in the network.
-
PLACEMENTS_LIMIT_REACHED - The number of active placements exceeds the max number allowed in the network.
-
LINE_ITEMS_LIMIT_REACHED - The number of line items excceeds the max number allowed in the network.
-
ACTIVE_LINE_ITEMS_LIMIT_REACHED - The number of active line items exceeds the max number allowed in the network.
-
DAI_ENCODING_PROFILES_LIMIT_REACHED - The number of not-archived encoding profiles exceeds the max number allowed in the network.
-
TRAFFIC_FORECAST_SEGMENTS_LIMIT_REACHED - The number of traffic forecast segments exceeds the max number allowed in the network.
-
FORECAST_ADJUSTMENTS_LIMIT_REACHED - The number of forecast adjustments exceeds the max number allowed in the network.
-
ACTIVE_EXPERIMENTS_LIMIT_REACHED - The number of active experiments exceeds the max number allowed in the network.
-
SITES_LIMIT_REACHED - The number of sites exceeds the max number allowed in the network.
-
USER_TEAMS_LIMIT_REACHED - The number of teams on the user exceeds the max number allowed.
-
ACTIVE_TARGETING_PRESETS_LIMIT_REACHED - The count of active targeting presets exceeds the limit.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
ExchangeRate
objects.Enumerations
-
INVALID_CURRENCY_CODE - The currency code is invalid and does not follow ISO 4217.
-
UNSUPPORTED_CURRENCY_CODE - The currency code is not supported.
-
CURRENCY_CODE_ALREADY_EXISTS - The currency code already exists. When creating an exchange rate, its currency should not be associated with any existing exchange rate. When creating a list of exchange rates, there should not be two exchange rates associated with same currency.
-
INVALID_EXCHANGE_RATE - The exchange rate value is invalid. When the
ExchangeRate.refreshRateisExchangeRateRefreshRate.FIXED, theExchangeRate.exchangeRateshould be larger than 0. Otherwise it is invalid. -
EXCHANGE_RATE_NOT_FOUND - The exchange rate value is not found. When the
ExchangeRate.refreshRateisExchangeRateRefreshRate.DAILYorExchangeRateRefreshRate.MONTHLY, theExchangeRate.exchangeRateshould be assigned by Google. It is not found if Google cannot find such an exchange rate. -
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
MISSING_FEATURE - A feature is being used that is not enabled on the current network.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
SERVER_NOT_AVAILABLE - The forecast could not be retrieved due to a server side connection problem. Please try again soon.
-
INTERNAL_ERROR - There was an unexpected internal error.
-
NO_FORECAST_YET - The forecast could not be retrieved because there is not enough forecasting data available yet. It may take up to one week before enough data is available.
-
NOT_ENOUGH_INVENTORY - There's not enough inventory for the requested reservation.
-
SUCCESS - No error from forecast.
-
ZERO_LENGTH_RESERVATION - The requested reservation is of zero length. No forecast is returned.
-
EXCEEDED_QUOTA - The number of requests made per second is too high and has exceeded the
allowable limit. The recommended approach to handle this error is to wait
about 5 seconds and then retry the request. Note that this does not
guarantee the request will succeed. If it fails again, try increasing the
wait time.
Another way to mitigate this error is to limit requests to 2 per second. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error.
-
OUTSIDE_AVAILABLE_DATE_RANGE - The request falls outside the date range of the available data.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
InternalApiError
s
are generally not the result of an invalid request or message sent by the
client.Enumerations
-
UNEXPECTED_INTERNAL_API_ERROR - API encountered an unexpected internal error.
-
TRANSIENT_ERROR - A temporary error occurred during the request. Please retry.
-
UNKNOWN - The cause of the error is not known or only defined in newer versions.
-
DOWNTIME - The API is currently unavailable for a planned downtime.
-
ERROR_GENERATING_RESPONSE - Mutate succeeded but server was unable to build response. Client should not retry mutate.
Enumerations
-
ILLEGAL_CHARACTERS - The URL contains invalid characters.
-
INVALID_FORMAT - The format of the URL is not allowed. This could occur for a number of reasons. For example, if an invalid scheme is specified (like "ftp://") or if a port is specified when not required, or if a query was specified when not required.
-
INSECURE_SCHEME - URL contains insecure scheme.
-
NO_SCHEME - The URL does not contain a scheme.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
DUPLICATE_ASSOCIATION - The label has already been attached to the entity.
-
INVALID_ASSOCIATION - A label is being applied to an entity that does not support that entity type.
-
NEGATION_NOT_ALLOWED - Label negation cannot be applied to the entity type.
-
DUPLICATE_ASSOCIATION_WITH_NEGATION - The same label is being applied and negated to the same entity.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
NOT_ALLOWED - The operation is not allowed due to lack of permissions.
-
NOT_APPLICABLE - The operation is not applicable for the current state of the LineItem .
-
HAS_COMPLETED - The LineItem is completed. A LineItemAction cannot be applied to a line item that is completed.
-
HAS_NO_ACTIVE_CREATIVES - The LineItem has no active creatives. A line item cannot be activated with no active creatives.
-
CANNOT_ACTIVATE_LEGACY_DFP_LINE_ITEM - A LineItem of type LineItemType.LEGACY_DFP cannot be Activated.
-
CANNOT_ACTIVATE_UNCONFIGURED_LINE_ITEM - A LineItem with publisher creative source cannot be activated if the corresponding deal is not yet configured by the buyer.
-
CANNOT_DELETE_DELIVERED_LINE_ITEM - Deleting an LineItem that has delivered is not allowed
-
CANNOT_RESERVE_COMPANY_CREDIT_STATUS_NOT_ACTIVE - Reservation cannot be made for line item because the LineItem.advertiserId
it is associated with has Company.creditStatus
that is not
ACTIVEorON_HOLD. -
CANNOT_ACTIVATE_INVALID_COMPANY_CREDIT_STATUS - Cannot activate line item because the LineItem.advertiserId
it is associated with has Company.creditStatus
that is not
ACTIVE,INACTIVE, orON_HOLD. -
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
ARG1_NULL - Assuming that a method will not have more than 3 arguments, if it does, return NULL
-
ARG2_NULL -
ARG3_NULL -
NULL -
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
NULL_CONTENT - Specified list/container must not contain any null elements
Enumerations
-
UNPARSABLE - Indicates an error in parsing an attribute.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
PERMISSION_DENIED - User does not have the required permission for the request.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
WRONG_PRECISION - The lowest N digits of the number must be zero.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
AUDIENCE_EXTENSION_NOT_SUPPORTED - Audience extension is not supported by programmatic line items.
-
AUTO_EXTENSION_DAYS_NOT_SUPPORTED - Auto extension days is not supported by programmatic line items.
-
VIDEO_NOT_SUPPORTED - Video is currently not supported.
-
ROADBLOCKING_NOT_SUPPORTED - Roadblocking is not supported by programmatic line items.
-
INVALID_CREATIVE_ROTATION - Programmatic line items do not support CreativeRotationType.SEQUENTIAL .
-
INVALID_LINE_ITEM_TYPE - Programmatic line items only support LineItemType.STANDARD and LineItemType.SPONSORSHIP if the relevant feature is on.
-
INVALID_COST_TYPE - Programmatic line items only support CostType.CPM .
-
SIZE_NOT_SUPPORTED - Programmatic line items only support a creative size that is supported by AdX. The list of supported sizes is maintained based on the list published in the help docs: https://support.google.com/adxseller/answer/1100453
-
ZERO_COST_PER_UNIT_NOT_SUPPORTED - Zero cost per unit is not supported by programmatic line items.
-
CANNOT_UPDATE_FIELD_FOR_APPROVED_LINE_ITEMS - Some fields cannot be updated on approved line items.
-
CANNOT_CREATE_LINE_ITEM_FOR_APPROVED_ORDER - Creating a new line item in an approved order is not allowed.
-
CANNOT_UPDATE_BACKFILL_WEB_PROPERTY_FOR_APPROVED_LINE_ITEMS - Cannot change backfill web property for a programmatic line item whose order has been approved.
-
COST_PER_UNIT_TOO_LOW - Cost per unit is too low. It has to be at least 0.005 USD.
-
INVALID_BUYER - Error which occurs when a buyer is invalid given the state of the programmatic line item.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
NOT_APPLICABLE - The operation is not applicable to the current state.
-
IS_ARCHIVED - The operation cannot be applied because the proposal is archived.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
AD_SERVER_UNKNOWN_ERROR - Unknown error from ad-server
-
AD_SERVER_API_ERROR - Ad-server reports an api error for the operation.
-
UPDATE_ADVERTISER_NOT_ALLOWED - Advertiser cannot be updated once the proposal has been reserved.
-
UPDATE_PROPOSAL_NOT_ALLOWED - Proposal cannot be updated when its status is not
DRAFTor it is archived. -
CONTACT_UNSUPPORTED_FOR_ADVERTISER - Contacts are not supported for advertisers in a programmatic Proposal .
-
INVALID_CONTACT - Contact associated with a proposal does not belong to the specific company.
-
DUPLICATED_CONTACT - Contact associated with a proposal's advertiser or agency is duplicated.
-
UNACCEPTABLE_COMPANY_CREDIT_STATUS - A proposal cannot be created or updated because the company
it is associated with has Company.creditStatus
that is not
ACTIVEorON_HOLD. -
COMPANY_CREDIT_STATUS_NOT_ACTIVE - Advertiser or agency associated with the proposal has Company.creditStatus
that is
not
ACTIVE. -
PRIMARY_AGENCY_REQUIRED - Cannot have other agencies without a primary agency.
-
PRIMARY_AGENCY_NOT_UNIQUE - Cannot have more than one primary agency.
-
UNSUPPORTED_COMPANY_ASSOCIATION_TYPE_FOR_PROGRAMMATIC_PROPOSAL - The Company association type is not supported for programmatic proposals .
-
DUPLICATED_COMPANY_ASSOCIATION - Advertiser or agency associated with a proposal is duplicated.
-
DUPLICATED_SALESPERSON - Found duplicated primary or secondary sales person.
-
DUPLICATED_SALES_PLANNER - Found duplicated sales planner.
-
DUPLICATED_TRAFFICKER - Found duplicated primary or secondary trafficker.
-
HAS_NO_UNARCHIVED_PROPOSAL_LINEITEMS - The proposal has no unarchived proposal line items.
-
DUPLICATE_TERMS_AND_CONDITIONS - One or more of the terms and conditions being added already exists on the proposal.
-
UNSUPPORTED_PROPOSAL_CURRENCY_CODE - The currency code of the proposal is not supported by the current network. All supported currencies can be found in the union of Network.currencyCode and Network.secondaryCurrencyCodes .
-
UNSUPPORTED_BUYER_CURRENCY_CODE - The currency code of the proposal is not supported by the selected buyer.
-
INVALID_POC - The POC value of the proposal is invalid.
-
UPDATE_CURRENCY_NOT_ALLOWED - Currency cannot be updated once the proposal has been reserved.
-
UPDATE_TIME_ZONE_NOT_ALLOWED - Time zone cannot be updated once the proposal has been sold.
-
UPDATE_SUPPLY_PATH_NOT_ALLOWED - The supply path type cannot be updated after creation.
-
BUYER_DISABLED_FOR_AGENCY_DIRECT - The buyer is not enabled for agency direct supply path.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
NOT_SAME_RATE_CARD - The proposal line item's rate card is not the same as other proposal line items in the proposal.
-
LINE_ITEM_TYPE_NOT_ALLOWED - The proposal line item's type is not yet supported by Sales Manager.
-
END_DATE_TIME_NOT_AFTER_START_TIME - The proposal line item's end date time is not after its start date time.
-
START_DATE_TIME_TOO_LATE_IN_MONTH - The proposal line item's start date time is too late in the month. This error applies to Programmatic Guaranteed deals sold on Nielsen audience measurement.
-
END_DATE_TIME_TOO_LATE - The proposal line item's end date time is after 1/1/2037.
-
START_DATE_TIME_IS_IN_PAST - The proposal line item's start date time is in past.
-
END_DATE_TIME_IS_IN_PAST - The proposal line item's end date time is in past.
-
FRONTLOADED_NOT_ALLOWED - Frontloaded delivery rate type is not allowed.
-
ALL_ROADBLOCK_NOT_ALLOWED - Roadblocking to display all creatives is not allowed.
-
ALL_COMPANION_DELIVERY_NOT_ALLOWED - Display all companions is not allowed.
-
CREATIVE_SET_ROADBLOCK_NOT_ALLOWED - Roadblocking to display all master and companion creative set is not allowed.
-
ALREADY_STARTED - Some changes may not be allowed because the related line item has already started.
-
CONFLICT_WITH_PRODUCT - The setting is conflict with product's restriction.
-
VIOLATE_BUILT_IN_TARGETING_COMPATIBILITY_RESTRICTION - The proposal line item's setting violates the product's built-in targeting compatibility restriction.
-
VIOLATE_BUILT_IN_TARGETING_LOCKED_RESTRICTION - The proposal line item's setting violates the product's built-in targeting locked restriction.
-
MOBILE_TECH_CRITERIA_NOT_SUPPORTED - Cannot target mobile-only targeting criteria.
-
UNSUPPORTED_TARGETING_TYPE - The targeting criteria type is unsupported.
-
WRONG_COST - The contracted cost does not match with what calculated from final rate and units bought.
-
NO_WEB_PROPERTY_FOR_TARGETED_REQUEST_PLATFORM - The proposal line item targets an inventory type for which the network does not have a corresponding web property.
-
CALCULATED_COST_TOO_HIGH - The cost calculated from cost per unit and units is too high.
-
INVALID_PRIORITY_FOR_LINE_ITEM_TYPE - The line item priority is invalid if it's different than the default.
-
UPDATE_PROPOSAL_LINE_ITEM_NOT_ALLOWED - Propsoal line item cannot update when it is archived.
-
CANNOT_UPDATE_TO_OR_FROM_CREATIVE_SET_ROADBLOCK - A proposal line item cannot be updated from having RoadblockingType.CREATIVE_SET to having a different RoadblockingType, or vice versa.
-
SEQUENTIAL_CREATIVE_ROTATION_NOT_ALLOWED - Serving creatives exactly in sequential order is not allowed.
-
UPDATE_RESERVATION_NOT_ALLOWED - Proposal line item cannot update its reservation detail once start delivering.
-
INVALID_COMPANION_DELIVERY_OPTION_FOR_ROADBLOCKING_TYPE - The companion delivery option is not valid for the roadblocking type.
-
INCONSISTENT_ROADBLOCK_TYPE - Roadblocking type is inconsistent with creative placeholders. If the roadblocking type is creative set, creative placeholders should contain companions, and vice versa.
-
INVALID_CONTRACTED_QUANTITY_BUFFER - ContractedQuantityBuffer is only applicable to standard line item with RateType.CPC / RateType.CPM / RateType.VCPM type.
-
INVALID_VALUES_FOR_CLICK_TRACKING_LINE_ITEM_TYPE - One or more values on the proposal line item are not valid for a LineItemType.CLICK_TRACKING line item type.
-
UPDATE_COST_ADJUSTMENT_NOT_ALLOWED - Proposal line item cannot update its cost adjustment after first approval.
-
UNSUPPORTED_RATE_CARD_CURRENCY_CODE - The currency code of the proposal line item's rate card is not supported by the current network. All supported currencies can be found in the union of Network.currencyCode and Network.secondaryCurrencyCodes .
-
END_DATE_TIME_IS_BEFORE_LAST_PAUSED_TIME - The corresponding line item is paused, but the proposal line item's end date time is before the last paused time.
-
VIDEO_INVALID_ROADBLOCKING - Video line items cannot have roadblocking options.
-
UPDATE_TIME_ZONE_NOT_ALLOWED - Time zone cannot be updated once the proposal line item has been sold.
-
INVALID_TIME_ZONE_FOR_RATE_TYPE - Time zone must be network time zone if the proposal line item is RateType.VCPM .
-
INVALID_TIME_ZONE_FOR_DEALS - Only the Network.timeZone is allowed for programmatic proposals .
-
INVALID_ENVIRONMENT_TYPE - The ProposalLineItem.environmentType is invalid.
-
SIZE_REQUIRED - At least one size must be specified.
-
COMPANION_NOT_ALLOWED - A placeholder contains companions but the roadblocking type is not RoadblockingType.CREATIVE_SET
or the
product typeis offline. -
MISSING_COMPANION - A placeholder does not contain companions but the roadblocking type is RoadblockingType.CREATIVE_SET .
-
DUPLICATED_MASTER_SIZE - A placeholder's master size is the same as another placeholder's master size.
-
INVALID_EXPECTED_CREATIVE_COUNT - Only creative placeholders with standard sizes can set an expected creative count.
-
CANNOT_HAVE_CREATIVE_TEMPLATE - Non-native placeholders cannot have creative templates.
-
NATIVE_CREATIVE_TEMPLATE_REQUIRED - Placeholders can only have native creative templates.
-
CANNOT_INCLUDE_NATIVE_PLACEHOLDER_WITHOUT_TEMPLATE_ID - Cannot include native placeholders without native creative templates.
-
INVALID_CLICK_TRACKING_LINE_ITEM_TYPE - One or more values are not valid for a LineItemType.CLICK_TRACKING line item type.
-
INVALID_TARGETING_FOR_CLICK_TRACKING - The targeting is not valid for a LineItemType.CLICK_TRACKING line item type.
-
INVALID_CONTRACTED_UNITS_BOUGHT - The contractedUnitsBought of the proposal line item is invalid.
-
PLACEHOLDER_CANNOT_CONTAIN_LABELS - Only creative placeholders with standard sizes can contain labels.
-
INVALID_LABEL_TYPE_IN_PLACEHOLDER - One or more labels on a creative placeholder is invalid.
-
PLACEHOLDER_CANNOT_CONTAIN_NEGATED_LABELS - A placeholder cannot contain a negated label.
-
CONTRACTED_UNITS_LESS_THAN_DELIVERED - Contracted impressions of programmatic proposal line item must be greater than already delivered impressions.
-
DISPLAY_ENVIRONMENT_MUST_HAVE_EXCLUDED_MOBILE_APPS_TARGETING - If AdExchangeEnvironment is DISPLAY, the proposal line item must have mobile apps as excluded device capability targeting.
-
MOBILE_ENVIRONMENT_MUST_HAVE_INCLUDED_MOBILE_APPS_TARGETING - If AdExchangeEnvironment is MOBILE, the proposal line item must have mobile apps as included device capability targeting.
-
SKIPPABLE_AD_TYPE_NOT_ALLOWED - The
SkippableAdTypeis not allowed. -
CROSS_SELL_TARGETING_UNSUPPORTED - Cross sell targeting is unsupported for this proposal line item.
-
CANNOT_SET_VIDEO_DURATION_ON_NON_VIDEO_DEAL - Can't set a video duration for non video deals.
-
UPDATE_VIDEO_CREATIVE_SKIPPABILITY_NOT_ALLOWED - Cannot update video creative skippability on a YouTube-targeted proposal line item once it has been sold (pushed to an order line item).
-
UPDATE_VIDEO_CREATIVE_FIELDS_NOT_ALLOWED - Cannot video creative fields on a YouTube-targeted proposal line item once it has been sold (pushed to an order line item).
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
ORIGINAL_ALREADY_HAS_MAKEGOOD - The original proposal line item for this makegood already has a makegood.
-
ORIGINAL_IS_MAKEGOOD - The original proposal line item for this makegood is itself a makegood.
-
ORIGINAL_NOT_YET_SOLD - The original proposal line item for this makegood has not been sold.
-
LINE_ITEM_IS_NOT_STANDARD - This makegood or its original is not a standard line item.
-
LINE_ITEM_IS_NOT_CPM - This makegood or its original is not a CPM line item.
-
MAKEGOODS_NOT_SUPPORTED_FOR_COST_TYPE - This makegood or its original has a cost type not supported on makegoods.
-
ORIGINAL_TOO_FAR_IN_PAST - The original proposal line item for this makegood is too far in the past.
-
RATE_DIFFERENT_THAN_ORIGINAL - This makegood has a rate that's different from the original proposal line item.
-
UNITS_MORE_THAN_ORIGINAL - This makegood has an impression goal greater than the original proposal line item.
-
MAKEGOODS_NOT_SUPPORTED_FOR_NON_DV360_BUYERS - Makegoods are not supported for non-DV360 buyers.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
INVALID_PRODUCT_TYPE - Programmatic proposal line items
only support
ProductType.DFP. -
VIDEO_NOT_SUPPORTED - EnvironmentType.VIDEO_PLAYER is currently not supported.
-
ROADBLOCKING_NOT_SUPPORTED - Programmatic proposal line items do not support RoadblockingType.CREATIVE_SET .
-
INVALID_CREATIVE_ROTATION - Programmatic proposal line items do not support CreativeRotationType.SEQUENTIAL .
-
INVALID_PROPOSAL_LINE_ITEM_TYPE - Programmatic proposal line items only support LineItemType.STANDARD .
-
INVALID_RATE_TYPE - Programmatic proposal line items only support RateType.CPM .
-
ZERO_COST_PER_UNIT_NOT_SUPPORTED - Programmatic proposal line items do not support zero for ProposalLineItem.netRate .
-
INVALID_PROGRAMMATIC_CREATIVE_SOURCE - Only programmatic proposal line items support ProgrammaticCreativeSource .
-
INVALID_MAX_VIDEO_CREATIVE_DURATION - Programmatic proposal line item has invalid video creative duration.
-
CANNOT_UPDATE_PROGRAMMATIC_CREATIVE_SOURCE - Cannot update programmatic creative source if the proposal line item has been sent to the buyer.
-
INVALID_NUM_UNITS - The Goal.units value is invalid.
-
MIX_GUARANTEED_AND_PREFERRED_DEAL_NOT_ALLOWED - Cannot mix guaranteed and Preferred Deal proposal line items in a programmatic proposal.
-
MIX_NATIVE_AND_BANNER_SIZE_NOT_ALLOWED - Cannot mix native and banner size in a programmatic proposal line item.
-
CANNOT_UPDATE_SIZES - Cannot update sizes when a programmatic proposal line item with publisher creative source is sent to a buyer.
-
INVALID_SPONSORSHIP_CONTRACTED_UNITS_BOUGHT - The {ProposalLineItem#contractedUnitsBought} cannot be
nullor zero for programmatic RateType.CPD proposal line items . -
INVALID_PROGRAMMATIC_PRICING_MODEL - Only
PricingModel.NETis supported for programmatic proposal line items . -
BUYER_DISABLED_FOR_PG_VIOLATING_SLA - Buyer is currently disabled for guaranteed deals due to violation of Programmatic Guaranteed service level agreement.
-
PG_NOT_SUPPORTED_FOR_AGENCY_BUYER - Deals with agencies are limited to preferred deals, private auctions, and public marketplace packages.
-
BUYER_NOT_FOUND - Buyer not found.
-
INVALID_ENVIRONMENT_PLATFORM_TYPE_PAIR - Cannot create/update proposal line items with an invalid environment and request platform pair.
-
CANNOT_MIX_AUDIO_VIDEO_PROGRAMMATIC_LINE_ITEM - A proposal line item must either be of video, or audio type, but not both.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
UNEXECUTABLE - Indicates that there was an error executing the PQL.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
UNPARSABLE - Indicates that there was a PQL syntax error.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
EXCEEDED_QUOTA - The number of requests made per second is too high and has exceeded
the allowable limit. The recommended approach to handle this error
is to wait about 5 seconds and then retry the request. Note that
this does not guarantee the request will succeed. If it fails
again, try increasing the wait time.
Another way to mitigate this error is to limit requests to 8 per second for Ad Manager 360 accounts, or 2 per second for Ad Manager accounts. Once again this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
-
REPORT_JOB_LIMIT - This user has exceeded the allowed number of new report requests
per hour (this includes both reports run via the UI and reports run
via ReportService.runReportJob
). The recommended approach to handle this error
is to wait about 10 minutes and then retry the request. Note that
this does not guarantee the request will succeed. If it fails
again, try increasing the wait time.
Another way to mitigate this error is to limit the number of new report requests to 250 per hour per user. Once again, this does not guarantee that every request will succeed, but may help reduce the number of times you receive this error.
-
SEGMENT_POPULATION_LIMIT - This network has exceeded the allowed number of identifiers uploaded within a 24 hour period. The recommended approach to handle this error is to wait 30 minutes and then retry the request. Note that this does not guarantee the request will succeed. If it fails again, try increasing the wait time.
Enumerations
-
TOO_HIGH -
TOO_LOW -
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
REQUIRED - A required collection is missing.
-
TOO_LARGE - Collection size is too large.
-
TOO_SMALL - Collection size is too small.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
REQUIRED - Missing required field.
Enumerations
-
REQUIRED -
TOO_LARGE -
TOO_SMALL -
TOO_LARGE_WITH_DETAILS -
TOO_SMALL_WITH_DETAILS -
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
SERVER_ERROR - Indicates that an unexpected error occured.
-
SERVER_BUSY - Indicates that the server is currently experiencing a high load. Please wait and try your request again.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
VARIABLE_NOT_BOUND_TO_VALUE - A bind variable has not been bound to a value.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
UNKNOWN -
ILLEGAL_CHARS - The input string value contains disallowed characters.
-
INVALID_FORMAT - The input string value is invalid for the associated field.
Enumerations
-
TOO_LONG -
TOO_SHORT -
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
ENTITY_NOT_ON_USERS_TEAMS - User cannot use this entity because it is not on any of the user's teams.
-
AD_UNITS_NOT_ON_ORDER_TEAMS - The targeted or excluded ad unit must be on the order's teams.
-
PLACEMENTS_NOT_ON_ORDER_TEAMS - The targeted placement must be on the order's teams.
-
MISSING_USERS_TEAM - Entity cannot be created because it is not on any of the user's teams.
-
ALL_TEAM_ASSOCIATION_NOT_ALLOWED - A team that gives access to all entities of a given type cannot be associated with an entity of that type.
-
INVALID_TEAM_ASSIGNMENT - The assignment of team to entities is invalid.
-
CANNOT_UPDATE_INACTIVE_TEAM - Cannot modify or create a team with an inactive status.
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.
Enumerations
-
INVALID_TIMEZONE_ID - Indicates that the timezone ID provided is not supported.
-
TIMEZONE_ID_IN_WRONG_FORMAT - Indicates that the timezone ID provided is in the wrong format. The timezone ID must be in tz database format (e.g. "America/Los_Angeles").
-
UNKNOWN - The value returned if the actual value is not exposed by the requested API version.

