Here are the common item-level issues by error reason, with their messages and details. For more information about the error message structure, see Error response structure .
B | C | D | E | F | G | I | M | N | P | Q | R | V
| Error Reason | Error Message |
|---|---|
BILLING_ACCOUNT_NOT_ACTIVE
|
The billing account associated with the requested resource is not active. Ensure your billing account is active and correctly linked to your Google Cloud project in the Cloud Console. |
BILLING_INSUFFICIENT_FUNDS_ACCOUNT
|
The billing account for the requested resource does not have sufficient funds to complete the operation. Add funds to your billing account to restore service. |
CANNOT_RECEIVE_SMS
|
The provided phone number is unable to receive text messages. Verify the phone number is correct and supports SMS. You may need to use a different phone number for verification. |
CONFLICT_CALCULATION_METHOD
|
The field {FIELD_LOCATION}
must define only one calculation method. Review your request and ensure that only one method (such as flat rate or carrier-based) is specified for this field. |
CONFLICT_CONCURRENT_MODIFICATION
|
A concurrent modification was detected because the resource was modified by another request during processing. Retrieve the latest version of the resource and try your update again. |
CONFLICT_ITEM_OUT_OF_ORDER_UPDATE
|
The operation was aborted because the last update for this item is more recent than the specified freshness_time
. Ensure you are using the most current data or update the freshness_time
to reflect the latest change. |
CONFLICT_PROMOTION_NOT_ALLOWED_FOR_UPDATE
|
The attributes in your promotion cannot be updated, or you are attempting to update a promotion that has already stopped. Review your promotion status and ensure you are only updating allowed attributes. |
CONFLICT_UNSUPPORTED_CONCURRENT_CONVERSION_SOURCE_CREATION
|
Creating multiple conversion sources concurrently is not supported. Sequentialize your requests to create conversion sources one at a time. |
DUPLICATE_ACCOUNT_LINKING_IN_PRODUCT_FILTERS
|
The Google Ads account is already linked to Business Manager. To link this account using product filters, you must first remove the existing link. |
DUPLICATE_CHECKOUT_SETTINGS
|
A checkoutSettings
resource with the name {RESOURCE_NAME}
already exists. Use a unique name for the new settings or update the existing checkoutSettings
resource. |
DUPLICATE_CONVERSION_SOURCE
|
The Google Analytics link already exists for this account. Verify your existing conversion sources. You cannot add the same link multiple times. |
DUPLICATE_EMAIL_ADDRESS
|
The email address {FIELD_VALUE}
has already been added. Remove the duplicate email address from your request and try again. |
DUPLICATE_FILENAME
|
A data feed with the filename {FORMATTED_FIELD_VALUE}
already exists. Use a unique filename for your data feed or update the existing one. |
DUPLICATE_FILE_NAME_VALUE
|
The filename
must be unique within the account. Provide a unique name for each file you upload. |
DUPLICATE_LINE_ITEM_ID
|
A duplicate line_item_id
was found in the request. Ensure that every line_item_id
within a single request is unique. |
DUPLICATE_NAME
|
The resource {RESOURCE_NAME}
already exists for merchant {ACCOUNT_ID}
. Choose a different name or update the existing resource. |
DUPLICATE_NAME_WITH_VALUE
|
The name in {FIELD_LOCATION}
with the value {FORMATTED_FIELD_VALUE}
is not unique. Ensure that names are unique across all resources of the same type. |
DUPLICATE_OFFER
|
A conflicting offer already exists: {FORMATTED_ITEM_MESSAGE}
. Verify the offer_id
and ensure you are not attempting to create a duplicate offer. |
DUPLICATE_OMNICHANNEL_SETTING
|
An omnichannel_setting
already exists for country {COUNTRY_CODE}
in account {ACCOUNT_ID}
. Update the existing setting instead of creating a new one. |
DUPLICATE_PRODUCT_ID
|
The product ID {PRODUCT_ID}
for merchant {ACCOUNT_ID}
appears more than once in this batch. Remove duplicate entries for the same product in your custom batch request. |
DUPLICATE_PRODUCT_ID_WITH_DATA_SOURCE_ID
|
The combination of product ID {PRODUCT_ID}
and data source ID {DATA_SOURCE_ID}
is repeated in this batch. Ensure each entry in the batch targets a unique product and data source combination. |
DUPLICATE_PROJECT_REGISTRATION
|
The Google Cloud project with ID {GCP_ID}
and number {GCP_NUMBER}
is already registered. You can view the existing registration using the getAccountForGcpRegistration
method. |
DUPLICATE_PROVIDER_AND_EXTERNAL_ACCOUNT_ID
|
The same provider ID and external account ID combination can only be added once per service type. Review your account links and avoid adding duplicate combinations. |
DUPLICATE_RESOURCE
|
The resource with the name {RESOURCE_NAME}
already exists. Use a unique identifier for the new resource. |
DUPLICATE_SHIPMENT_ID
|
A duplicate shipment_id
was detected. Ensure all shipment IDs are unique within your request. |
DUPLICATE_VALUE_IN_REGION_BATCH
|
A duplicate value {FIELD_VALUE}
was found for the field {FIELD_LOCATION}
in this batch. Ensure all values in the region batch are unique. |
EXPIRED_PHONE_VERIFICATION_ID
|
The phone verification ID has expired. Request a new verification ID and complete the verification process promptly. |
EXPIRED_RELATIONSHIP_VERIFICATION_PERIOD
|
The verification period for the relationship {RELATIONSHIP}
with account {ACCOUNT_ID}
has expired. Re-verify the account relationship to restore access. |
FLAT_RATE_ONLY
|
The rate for {FIELD_LOCATION}
defines a single value. Use a flat rate instead of complex calculation methods for single rates. |
GCP_NOT_REGISTERED
|
The Google Cloud project {GCP_ID}
(number {GCP_NUMBER}
) is not registered with this merchant account. Follow the registration guide
to register your project. |
GCP_NOT_REGISTERED_NO_CONTACT
|
The Google Cloud project is registered, but it lacks a user with the API_DEVELOPER
role. Add at least one user with the API_DEVELOPER
role to the project and ensure they have a valid email address. |
IMMUTABLE_FIELD_UPDATED
|
The field {FIELD_LOCATION}
cannot be modified after creation. Don't include this field in your update mask or request. |
INVALID_ACCOUNT_FOR_GBP_SERVICE
|
The account accounts/{ACCOUNT_ID}
is not eligible for the Google Business Profile service. Ensure the account is correctly set up as a Merchant Center or CSS account. |
INVALID_ACCOUNT_ID
|
The account ID {ACCOUNT_ID}
is invalid. Verify the account ID is numeric and correct. |
INVALID_ACCOUNT_ID_ALIAS
|
The accountIdAlias
is invalid: {FORMATTED_ITEM_MESSAGE}
. Ensure the alias follows the format providerId~alias
. |
INVALID_ACCOUNT_ID_ALIAS_CANNOT_BE_CHANGED_ON_AUTOSELLERS
|
The accountIdAlias
cannot be changed for accounts managed by Google. These accounts manage their own lifecycle; aliases are immutable. |
INVALID_ACCOUNT_ID_ALIAS_NOT_SUPPORTED
|
The accountIdAlias
is not supported for this specific relationship. Use the standard account ID instead of an alias. |
INVALID_ACCOUNT_ID_IN_NAME
|
The account ID in the resource name {NAME}
must be numeric. Format the resource name as accounts/{ACCOUNT_ID}
where the ID is a number. |
INVALID_ACCOUNT_ID_IN_PARENT
|
The account ID in {FIELD_LOCATION}
must be numeric. Provide a valid numeric account ID, such as accounts/123
. |
INVALID_ACCOUNT_TYPE_FOR_LABEL_UPDATE
|
Label updates are only supported for CSS Domain and Merchant Center accounts. Verify your account type before attempting a label update. |
INVALID_ACCOUNT_VALIDATION_FAILED
|
The account failed validation: {VALIDATION_ERRORS}
. Correct the listed validation errors and resubmit the request. |
INVALID_ACTION_CONTEXT
|
The action context is invalid. Ensure you are calling the method within the correct scope or environment. |
INVALID_ACTUAL_DELIVERY_TIME_BEFORE_SHIPPED_TIME
|
The actual_delivery_time
cannot be before the shipped_time
. Adjust the timestamps so that delivery occurs after shipping. |
INVALID_ARGUMENT_WITH_NAME
|
The operation on {RESOURCE_NAME}
failed due to an invalid argument. Check the documentation for the specific resource and verify all arguments. |
INVALID_ATTRIBUTE_OR_TOP_LEVEL_FIELDS_FOR_REGIONAL_INVENTORY
|
You must set either regional_inventory_attributes
or individual attributes, but not both. Choose one method for defining regional inventory. |
INVALID_ATTRIBUTE_OR_TOP_LEVEL_FIELDS_SET_FOR_LOCAL_INVENTORY
|
You must set either local_inventory_attributes
or individual attributes, but not both. Choose one method for defining local inventory. |
INVALID_AT_LEAST_ONE_USER_REQUIRED_FOR_SERVICE
|
Accounts with comparison shopping or management services require at least one user. Provide a user email address in your request. |
INVALID_AUTH_DETAIL_ACCESS_RIGHT
|
The access right {FIELD_VALUE}
is invalid. Refer to the AccessRight documentation
for valid values. |
INVALID_BOTH_SET
|
Both {FIELD_LOCATION_1}
and {FIELD_LOCATION_2}
must be provided together. Ensure both fields are set in your request. |
INVALID_BOTH_SET_OR_UNSET
|
Fields {FIELD_LOCATION_1}
and {FIELD_LOCATION_2}
must either both be set or both be unset. Coordinate these two fields in your request. |
INVALID_CANNOT_UPDATE_PROMOTIONS_CONSENT_TO_UNSPECIFIED
|
Promotions consent cannot be updated to UNSPECIFIED
. Select a valid consent status (such as GRANTED
or DENIED
). |
INVALID_CHANNEL
|
The channel {CHANNEL}
is invalid. Use a supported channel like ONLINE
or LOCAL
. |
INVALID_CHECKOUT_SETTINGS_DESTINATION
|
Checkout cannot be enabled for {DESTINATIONS}
due to missing eligible regions. Configure eligible regions for these destinations before enabling checkout. |
INVALID_CHECKOUT_SETTINGS_DESTINATION_IN_REQUEST
|
The request contains invalid destinations: {DESTINATIONS}
. Review the {VALIDATION_ERRORS}
and correct the destination codes. |
INVALID_COMPARATOR_NOT_SUPPORTED_FOR_FIELD
|
The comparator {COMPARATOR}
is not supported for the field {FIELD_NAME}
. Use a supported comparator (such as EQUALS
, GREATER_THAN
) for this field. |
INVALID_CONDITION
|
The condition for {FIELD_LOCATION}
is invalid: {FORMATTED_FIELD_VALUE}
. Review the condition syntax and values. |
INVALID_CONTENT_LANGUAGE
|
The content language {FIELD_VALUE}
is invalid. Use a two-letter ISO 639-1 language code (such as en
, fr
). |
INVALID_CONTENT_LANGUAGE_NOT_SUPPORTED
|
The specified content language {FIELD_VALUE}
is not supported. Check the list of supported languages for the target country. |
INVALID_CONVERSION_SOURCE_TYPE
|
The conversion source type is not supported for this operation. Verify the type for conversion source {CONVERSION_SOURCE_ID}
. |
INVALID_COUNTRY_CODE
|
The country code {COUNTRY_CODE}
is invalid. Use a valid CLDR territory code (such as US
, GB
). |
INVALID_CSS_ACCOUNT_ID
|
The CSS account ID {ACCOUNT_ID}
is invalid. Verify the ID is a valid number associated with a CSS. |
INVALID_CURRENCY_CODE
|
The currency code {FIELD_VALUE}
is invalid. Use a valid ISO 4217 code (such as USD
, EUR
). |
INVALID_CURRENCY_NOT_SUPPORTED_IN_COUNTRY
|
The currency is not supported in the target country. Use a supported currency for your products in that region. |
INVALID_CUSTOMER_SHIPPING_FEE_CURRENCY_CODE
|
The currency code for the shipping fee is invalid. Provide a valid ISO 4217 currency code. |
INVALID_CUSTOMER_SHIPPING_FEE_CURRENCY_CODE_NOT_SUPPORTED
|
The selected shipping fee currency is not supported. Choose a supported currency for shipping fees. |
INVALID_DATA_SOURCE_CHANNEL_MISMATCH_PRODUCT
|
The data source channel does not match the product channel. Ensure the data source is configured for the same channel (such as ONLINE
) as the products. |
INVALID_DATA_SOURCE_DOES_NOT_MATCH_ITEM
|
The data source does not match the item. Verify that the item is being uploaded to the correct data source. |
INVALID_DATA_SOURCE_FEED_LABEL_OR_LANGUAGE_MISMATCH_ITEM
|
Couldn't find a valid data target for the provided feedLabel
and contentLanguage
. Ensure the labels match your data source configuration. |
INVALID_DATA_SOURCE_MUST_HAVE_API_INPUT_TYPE
|
The data source must have an API
input type for this operation. Create or update the data source to use API input. |
INVALID_DATA_SOURCE_NAME
|
The data source reference in {FIELD_LOCATION}
is invalid: {FIELD_VALUE}
. Use the format accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}
. |
INVALID_DATA_SOURCE_NOT_PART_OF_ACCOUNT
|
The data source is not part of the account targeted by this request. Verify the data source ID and the account ID. |
INVALID_DATA_SOURCE_VERTICAL_MISMATCH_ITEM
|
The provided data source does not support {EXPECTED_VERTICAL}
. Use a data source that matches the product vertical. |
INVALID_DATA_SOURCE_WITHOUT_SCHEDULE
|
The data feed lacks a schedule and cannot be fetched. Configure a fetch schedule for the data source. |
INVALID_DATE_TIME
|
The DateTime
value is invalid. Use the RFC 3339 format (such as 2023-10-01T12:00:00Z
). |
INVALID_DATE_TIME_GRANULARITY
|
The date {DATE}
in {CONDITION}
is invalid. Ensure the date represents the first day of a week (Monday) or month. |
INVALID_DELIVERY_POSTAL_CODE
|
The delivery postal code is invalid for the specified country. Check the postal code format for the target country. |
INVALID_DELIVERY_REGION_CODE
|
The delivery region code is not supported. Use a supported region code for your delivery settings. |
INVALID_DELIVERY_REGION_CODE_WITH_VALUE
|
The delivery region code is invalid. Verify the code matches standard region identifiers. |
INVALID_DEPRECATED_CHANNEL_FIELD
|
The channel
field is deprecated. Use the legacyLocal
field set to true
instead for local products. |
INVALID_DESTINATIONS
|
The destinations for the feed are invalid. Review the destination codes (such as Shopping_ads
, Free_listings
). |
INVALID_DESTINATION_NAME
|
The destination name {FIELD_VALUE}
is invalid. Use a valid destination identifier. |
INVALID_DESTINATION_NOT_ENABLED
|
At least one destination must be enabled. Enable a destination (such as Shopping Ads) in your feed settings. |
INVALID_EMAIL_ADDRESS
|
The value {FIELD_VALUE}
is not a valid email address. Provide a correctly formatted email address (such as user@example.com
). |
INVALID_EXPECTED_NON_REPEATED_VALUE
|
Only one value was expected for {FIELD_LOCATION}
. Provide a single value instead of an array or list. |
INVALID_EXPIRATION_DATE_TOO_CLOSE
|
The expiration date {FIELD_VALUE}
is too close to the current time. Ensure the date is at least {RANGE_MIN}
in the future. |
INVALID_EXTERNAL_ACCOUNT_ID
|
The external_account_id
is invalid. Verify the ID format provided by your external system. |
INVALID_EXTERNAL_ACCOUNT_ID_NOT_SUPPORTED
|
The external_account_id
is not supported for this service. Remove this field from your request. |
INVALID_EXTERNAL_ACCOUNT_ID_TOO_LONG
|
The external account ID exceeds the maximum allowed length. Use a shorter identifier. |
INVALID_EXTERNAL_ACCOUNT_ID_WITH_LOCATION
|
The external_account_id
is invalid. Correct the ID provided in the request. |
INVALID_FEED_LABEL
|
The feed label {FIELD_VALUE}
is invalid. Use a valid region code (such as US
, GB
) as the label. |
INVALID_FEED_LABEL_WITH_LOCATION
|
The feed label {FIELD_VALUE}
is invalid. Use a valid region code identifier. |
INVALID_FIELD_ALREADY_FILTERED
|
The field {FIELD_NAME}
cannot be filtered multiple times. Combine your filters into a single predicate. |
INVALID_FIELD_MASK_PATH
|
The following field paths are invalid: {PATHS}
. Use only supported field names in your update mask. |
INVALID_FILTERING_BY_FIELD_ONLY_POSSIBLE_WITH_PROVIDER_ID
|
Filtering by {FIELD_LOCATION}
requires a providerId
predicate. Add a providerId
to your filter. |
INVALID_FILTER_SYNTAX
|
The filter syntax is invalid: {VALIDATION_ERRORS}
. Review the query syntax guidelines for Merchant API. |
INVALID_FRESHNESS_TIME_NOT_IN_RANGE
|
The freshness time {FIELD_VALUE}
is not close enough to the current time. Ensure it is within {RANGE_MIN}
before and {RANGE_MAX}
after the current time. |
INVALID_FULL_UPDATE_MASK_REPLACEMENT_NOT_SUPPORTED
|
Full resource replacement is not supported. Provide a specific field mask to update only the necessary fields. |
INVALID_GBP_EMAIL
|
The Google Business Profile email {GBP_EMAIL}
is invalid. Use the email address linked to your GBP account. |
INVALID_GTIN_DOES_NOT_MATCH_PRODUCT_ID
|
The gtin
does not match the product ID. Ensure the GTIN is correct for the specified product. |
INVALID_ID_WITHIN_TYPE_MUST_BE_INTEGER
|
The ID for this conversion source must be an integer. Check the conversion source {CONVERSION_SOURCE_ID}
and use a numeric ID. |
INVALID_INCONSISTENT_UNITS
|
The units for {FIELD_LOCATION}
are inconsistent: {FORMATTED_ITEM_MESSAGE}
. Standardize the units (such as use the same currency or weight unit) across the field. |
INVALID_INVENTORY_VERIFICATION_NOT_SUPPORTED_FOR_MHLSF
|
Inventory verification is not supported for Merchant-hosted Local Storefront in field {FIELD_LOCATION}
. Use a supported storefront type for inventory verification. |
INVALID_ITEM_ID
|
The item ID {FIELD_VALUE}
is invalid. Ensure the ID follows the required format and does not contain illegal characters. |
INVALID_ITEM_UPDATE_ATTRIBUTE
|
{FIELD_VALUE}
is not a valid attribute name for {FIELD_LOCATION}
. Use standard attribute names from the product schema. |
INVALID_ITEM_UPDATE_SUBATTRIBUTE
|
Sub-attributes are not allowed in the update path for {FIELD_VALUE}
. Update the top-level attribute instead. |
INVALID_ITEM_UPDATE_UNSUPPORTED
|
Updating {FIELD_VALUE}
using this path is not supported. Check the API documentation for modifiable fields. |
INVALID_LANGUAGE_CODE
|
The language code for {FIELD_LOCATION}
is invalid: {FIELD_VALUE}
. Use a valid IETF BCP-47 code like en-US
. |
INVALID_LATEST_DELIVERY_PROMISE_BEFORE_EARLIEST_PROMISE
|
The latest delivery promise cannot be before the earliest promise. Correct your delivery time range. |
INVALID_LFP_PROVIDER
|
The lfp_provider
must be a valid number in {FIELD_LOCATION}
. Provide the numeric provider ID. |
INVALID_LIMIT_SCOPE
|
The limit scope {FIELD_VALUE}
is unsupported. Refer to the Scope documentation
for valid values. |
INVALID_LIMIT_TYPE
|
The limit type {FIELD_VALUE}
is unsupported. Use a supported limit type from the quota documentation
. |
INVALID_LINE_ITEM_ID_MAPPING_NOT_PRESENT_IN_LINE_ITEMS
|
The line_item_id
in your mapping does not exist in the line items. Ensure all mapped IDs exist in the main line item list. |
INVALID_LOCAL_ONLY_PRODUCT_CAN_HAVE_ONLINE_CHANNEL
|
Local-only products cannot be assigned to an online channel. Set the channel to LOCAL
for these items. |
INVALID_MISMATCHED_CHANNEL
|
The channel {CHANNEL}
is incorrect. Use the expected channel {EXPECTED_CHANNEL}
instead. |
INVALID_MISSING_REQUIRED_FIELD_WITH_FORMATTED_MESSAGE
|
The field {FIELD_LOCATION}
is required: {FORMATTED_ITEM_MESSAGE}
. Provide the missing field in your request. |
INVALID_MPN_DOES_NOT_MATCH_PRODUCT_ID
|
The mpn
(Manufacturer Part Number) does not match the product ID. Verify the MPN for this product. |
INVALID_NAME
|
The resource name {NAME}
is invalid. Follow the resource naming conventions (such as accounts/{ACCOUNT_ID}/products/{PRODUCT_ID}
). |
INVALID_NAME_PART_NOT_NUMBER
|
The part {VARIABLE_NAME}
of the resource name must be numeric, but received {FIELD_VALUE}
. Ensure all ID parts of the resource name are numbers. |
INVALID_NEGATIVE_CUSTOMER_SHIPPING_FEE
|
The customer shipping fee cannot be a negative value. Provide a zero or positive fee. |
INVALID_NON_POSITIVE_ITEM_QUANTITY
|
The item quantity must be greater than zero. Provide a valid positive integer. |
INVALID_NOT_A_NUMBER
|
The field {FIELD_LOCATION}
expected a number but received {FIELD_VALUE}
. Ensure the value is numeric. |
INVALID_NOT_A_NUMBER_ACCOUNT_ID
|
The account ID in {FIELD_LOCATION}
must be a number. Remove non-numeric characters from the account ID. |
INVALID_NOT_A_NUMBER_DATA_SOURCE_ID
|
The data source ID in {FIELD_LOCATION}
must be a number. Provide a numeric data source ID. |
INVALID_NOT_A_PRIMARY_DATA_SOURCE
|
The ID does not represent a primary data source. Verify you are referencing a primary feed and not a supplemental one. |
INVALID_NOT_A_PRODUCT_DATA_SOURCE
|
The data source type at {FIELD_LOCATION}
is not a products data source. Use a data source intended for product information. |
INVALID_NOT_SUPPORTED_DATA_SOURCE_TYPE
|
The data feed type is not supported: {FORMATTED_ITEM_MESSAGE}
. Refer to the supported data source types in the documentation. |
INVALID_OMNICHANNEL_SETTING
|
The omnichannel_setting
must be a valid country code in {FIELD_LOCATION}
. Ensure the code matches the resource name country. |
INVALID_OMNICHANNEL_SETTING_ABOUT_NOT_SUPPORTED
|
The "About" setting is not supported in {COUNTRY_CODE}
. Remove this setting for the specified country. |
INVALID_OMNICHANNEL_SETTING_LSF_TYPE
|
The Local Storefront type {LSF_TYPE}
is unsupported in {FIELD_LOCATION}
. Use a supported storefront type. |
INVALID_ONLY_LATEST_FILE_UPLOAD_ALLOWED
|
Only the latest
value is supported for file uploads, but received {FILE_UPLOAD}
. Use latest
to reference the most recent upload. |
INVALID_ONLY_ONE_ATTRIBUTE_FIELD_SET
|
Only one of attributes
or product_attributes
can be set. We recommend using product_attributes
. |
INVALID_ONLY_ONE_ATTRIBUTE_FIELD_SET_FOR_UPDATE_MASK
|
You cannot update both attributes
and product_attributes
in the same request. Pick one field to update. |
INVALID_ORDER_CREATED_TIME_AFTER_OTHER_TIMES_IN_SHIPMENTS
|
The order creation time must be earlier than all shipment timestamps. Correct the order_created_time
. |
INVALID_ORDER_UPDATE_NOT_IN_FUTURE
|
The update time on the external system cannot be in the future. Use a current or past timestamp. |
INVALID_ORIGIN_POSTAL_CODE
|
The origin postal code is invalid for the specified country. Verify the sender's postal code. |
INVALID_ORIGIN_REGION_CODE
|
The origin region code is invalid. Use a supported region identifier. |
INVALID_ORIGIN_REGION_CODE_NOT_SUPPORTED
|
The origin region code is not supported. Use a different region for the origin. |
INVALID_PAGE_SIZE_NEGATIVE
|
The page_size
must be a non-negative number. Use a value of zero or greater. |
INVALID_PAGE_TOKEN
|
The provided page token is invalid or expired. Use the next_page_token
returned by the previous list request. |
INVALID_PARAMETER_ORDER_UPDATE_NEGATIVE_PRICE
|
The price value cannot be negative in {FIELD_LOCATION}
. Provide a valid non-negative price. |
INVALID_PARAMETER_ORDER_UPDATE_NEGATIVE_QUANTITY
|
The quantity cannot be negative. Use a zero or positive integer. |
INVALID_PARAMETER_ORDER_UPDATE_NEGATIVE_TOTAL_AMOUNT
|
The total amount cannot be negative in {FIELD_LOCATION}
. Correct the total amount value. |
INVALID_PARAMETER_WITH_FORMATTED_MESSAGE
|
The parameter {FIELD_LOCATION}
is invalid: {FORMATTED_ITEM_MESSAGE}
. Correct the parameter based on the error details. |
INVALID_PRICE_MUST_BE_POSITIVE
|
The price must be greater than or equal to zero. Provide a valid numeric price. |
INVALID_PRIMARY_DATA_SOURCE_CROSS_JOIN_NOT_ALLOWED
|
Joins cannot be performed across different primary data sources. Use SELF
when referencing the existing primary data source instead of an explicit reference. |
INVALID_PRODUCT_DELIVERY_TIME
|
The product delivery time is invalid. Ensure the delivery estimates follow the correct format and logic. |
INVALID_PRODUCT_FILTER_ATTRIBUTE_TYPE_NOT_SUPPORTED
|
The product filter uses an unsupported attribute type: {FIELD_VALUE}
. Use a supported attribute for filtering. |
INVALID_PRODUCT_FILTER_ATTRIBUTE_VALUE
|
The product filter contains an invalid attribute value: {FIELD_VALUE}
. Correct the value provided in the filter. |
INVALID_PRODUCT_FILTER_ATTRIBUTE_VALUE_TOO_LONG
|
The attribute value {FIELD_VALUE}
exceeds the maximum length of {LIMIT_VALUE}
. Shorten the attribute value. |
INVALID_PRODUCT_FILTER_DUPLICATE_ATTRIBUTE_TYPE
|
A duplicate attribute {FIELD_VALUE}
was found in the filter. Each attribute should appear at most once per predicate. |
INVALID_PRODUCT_ID
|
The product ID format is invalid. Follow the valid ID format: {PRODUCT_ID_FORMAT}
. |
INVALID_PRODUCT_ID_DOES_NOT_EXIST_FOR_MERCHANT
|
The product ID does not exist for this merchant account. Verify the product ID or create the product first. |
INVALID_PROGRAM
|
The program {NAME}
is invalid. Expected program type: {PROGRAM_TYPE}
. |
INVALID_PROMOTION_ALREADY_EXPIRED
|
The promotion has already expired. Check the effective_end_time
. |
INVALID_PROMOTION_BOTH_INCLUSIONS_AND_EXCLUSIONS_EXIST
|
You cannot have both inclusions and exclusions for a single custom filter attribute. Pick one filtering method. |
INVALID_PROMOTION_CONFLICT_BENEFIT_OR_RESTRICTION
|
The promotion has both benefit and restriction attributes set. Use either benefits or restrictions, as appropriate for the promotion type. |
INVALID_PROMOTION_DESTINATION_CHANNEL_CONFLICT
|
The promotion destination is incompatible with its channel. Verify that local promotions target local destinations. |
INVALID_PROMOTION_DESTINATION_UNSUPPORTED
|
The promotion is not supported on one or more of its destinations. Remove unsupported destinations from the list. |
INVALID_PROMOTION_DISPLAY_END_TIME_BEFORE_START_TIME
|
The display end time is earlier than the start time. Correct the promotion display timestamps. |
INVALID_PROMOTION_DURATION_EXCEEDS_LIMIT
|
The promotion duration exceeds the allowed limit. Shorten the promotion period. |
INVALID_PROMOTION_EFFECTIVE_END_TIME_BEFORE_START_TIME
|
The effective end time is earlier than the start time. Adjust the effective timestamps. |
INVALID_PROMOTION_ID
|
The promotion ID is invalid. Verify the ID format and ensure it matches existing promotions if updating. |
INVALID_PROMOTION_MISSING_BENEFIT_OR_RESTRICTION
|
Benefit or restriction attributes are missing for this promotion type. Provide the required attributes for the promotion. |
INVALID_PROMOTION_MISSING_SHIPPING_SERVICE_RESTRICTION
|
Shipping service restriction is missing for a shipping promotion. Specify which shipping services the promotion applies to. |
INVALID_PROMOTION_NO_REDEMPTION_CODE
|
No redemption code was provided. Add a code if the promotion requires one. |
INVALID_PROMOTION_NO_STORE_APPLICABILITY
|
The store_applicability
attribute is required for local promotions. Specify which stores are eligible. |
INVALID_PROMOTION_NO_STORE_INCLUSIONS_OR_EXCLUSIONS
|
No store codes were included or excluded for this store-specific promotion. Add at least one store code. |
INVALID_PROMOTION_REDEMPTION_CHANNEL
|
Promotions must contain between one and two channels. Adjust the redemption_channel
list. |
INVALID_PROMOTION_UNEXPECTED_REDEMPTION_CODE
|
An unexpected redemption code was found. Remove the code if the promotion type doesn't support it. |
INVALID_PROMOTION_UNEXPECTED_SHIPPING_SERVICE_RESTRICTION
|
An unexpected shipping service restriction was found. Remove restrictions that doesn't apply to this promotion type. |
INVALID_PROMOTION_UNEXPECTED_STORE_APPLICABILITY
|
The store_applicability
attribute can only be used with local promotions. Remove this attribute for online promotions. |
INVALID_PROMOTION_UNEXPECTED_STORE_EXCLUSIONS
|
Unexpected store exclusions were provided. Review the promotion configuration. |
INVALID_PROMOTION_UNEXPECTED_STORE_INCLUSIONS
|
Unexpected store inclusions were provided. Review the promotion configuration. |
INVALID_PROMOTION_UNSUPPORTED_DESTINATION_COUNTRY
|
The destination is not supported in the chosen country. Use a supported destination for the country. |
INVALID_PROMOTION_UNSUPPORTED_DESTINATION_COUNTRY_WITH_VALUE
|
The destination {ISSUE_VALUE}
is not supported in the chosen country. Select an eligible destination. |
INVALID_PROMOTION_UNSUPPORTED_LOCAL_PROMOTION_TYPE
|
Free shipping types are not supported for local promotions. Choose a supported local promotion type. |
INVALID_PROMOTION_URL
|
The promotion URL format is invalid. Provide a valid URL (such as starting with //
). |
INVALID_PROMOTION_URL_REQUIRED_FOR_LOCAL_DESTINATION
|
A promotion URL is required for local promotions. Add a valid URL to the promotion. |
INVALID_PROVIDER
|
The provider must be in the format providers/{account}
or accounts/{account}
. Correct the provider identifier. |
INVALID_PROVIDER_FOR_SUBACCOUNTS
|
The provider for sub-accounts must use the accounts/{account}
format. Use the numeric account ID. |
INVALID_PROVIDER_ID
|
The ID portion after accounts/
or providers/
must be a number. Remove non-numeric characters from the ID. |
INVALID_QUERY
|
The query is invalid: {VALIDATION_ERRORS}
. Correct the query syntax according to the Merchant API search language. |
INVALID_REFERENCE
|
The reference {FORMATTED_FIELD_VALUE}
does not refer to an existing element. Ensure the referenced resource ID is correct and already exists. |
INVALID_REGION_CODE
|
The region code for {FIELD_LOCATION}
is invalid: {FIELD_VALUE}
. Use a valid CLDR territory code like US
. |
INVALID_REGISTRATION_ADDRESS
|
The address format is invalid. Use the PostalAddress format . |
INVALID_REGISTRATION_CUSTOMER_SERVICE_EMAIL
|
The customer service email address is invalid. Provide a valid email address for customer support. |
INVALID_REGISTRATION_CUSTOMER_SERVICE_PHONE_NUMBER
|
The customer service phone number is invalid. Use the PhoneNumber format . |
INVALID_REGISTRATION_KOREAN_BUSINESS_NUMBER
|
The Korean business registration number is invalid. Use the format XXX-XX-XXXXX
where X is a digit. |
INVALID_REQUEST
|
The request is invalid. Check the API documentation for correct parameters and structure. |
INVALID_SERVICE_COMBINATION
|
The combination of services provided is not allowed. AccountManagement
cannot be specified together with AccountAggregation
or ComparisonShopping
. |
INVALID_SERVICE_ID
|
The service ID {FIELD_VALUE}
in {FIELD_LOCATION}
is malformed. Check the ID format in the documentation. |
INVALID_SET_ALIAS_PROVIDER_NOT_IN_SERVICES
|
Provider {ACCOUNT_ID}
in setAlias
must be present in at least one service. Add the provider to a service first. |
INVALID_SHIPMENT_ID_MAPPING_NOT_PRESENT_IN_SHIPMENTS
|
The shipment_id
in your mapping does not exist in the shipments list. Synchronize your IDs. |
INVALID_SHIPPING_SETTINGS
|
The shipping settings for {FIELD_LOCATION}
are invalid. Refer to the ShippingSettings documentation
for guidance. |
INVALID_SHIPPING_SETTINGS_WITH_FORMATTED_MESSAGE
|
The shipping settings for {FIELD_LOCATION}
are invalid: {FORMATTED_ITEM_MESSAGE}
. Correct the specific issue mentioned in the message. |
INVALID_STATE_ACCOUNT_CANNOT_BE_DELETED_HAS_PROCESSED_OFFERS
|
This account cannot be deleted because it still contains processed offers. Remove all offers before deleting the account. |
INVALID_STATE_ACCOUNT_CANNOT_BE_DELETED_PROVIDES_SERVICES
|
The account cannot be deleted because it provides services to other accounts. Terminate all service relationships before deletion. |
INVALID_STATE_AUTOSELLER_NAME_FIXED
|
The merchant name cannot be updated because it is an auto-seller account. Auto-seller lifecycle is managed by Google. |
INVALID_STATE_CANNOT_FETCH_ON_MULTIPLE_FILE_INPUTS
|
Fetching is only available for data sources with a single file input. Reduce the number of file inputs to one. |
INVALID_STATE_CANNOT_FETCH_ON_NO_FILE_INPUTS
|
The data source must contain at least one file input to be fetched. Add a file input configuration. |
INVALID_STATE_CLAIM_UNVERIFIED_HOMEPAGE
|
The homepage for account {FORMATTED_FIELD_VALUE}
is not verified. Verify the homepage ownership in Merchant Center. |
INVALID_STATE_FAILED_PRECONDITION_WITH_NAME
|
The operation on {RESOURCE_NAME}
failed because a precondition was not met. Review the resource state and requirements. |
INVALID_STATE_FETCH_FILE_ERROR
|
The data source cannot be fetched. Verify the fetch URL and server permissions. |
INVALID_STATE_HOMEPAGE_CLAIMED_AT_LOWER_LEVEL
|
Another account conflicts with the homepage claim for {FORMATTED_FIELD_VALUE}
. Set the overwrite
parameter to true
to take the claim. |
INVALID_STATE_HOMEPAGE_NOT_VERIFIED
|
The homepage is not verified. Complete the website verification process in Merchant Center. |
INVALID_STATE_INVALID_STATE_NO_HOMEPAGE_TO_UNCLAIM
|
The account does not have a homepage that can be unclaimed. Verify if a homepage was ever claimed. |
INVALID_STATE_INVENTORY_VERIFICATION_ALREADY_APPROVED
|
Inventory verification has already been approved for country {COUNTRY_CODE}
. No further action is needed for this country. |
INVALID_STATE_INVENTORY_VERIFICATION_ALREADY_RUNNING
|
Inventory verification is already in progress for country {COUNTRY_CODE}
. Wait for the current verification to complete. |
INVALID_STATE_INVENTORY_VERIFICATION_NOT_ALLOWED
|
Inventory verification is not allowed for country {COUNTRY_CODE}
at this time. Check eligibility requirements for local inventory ads. |
INVALID_STATE_IN_STOCK_UPDATE_NOT_ALLOWED
|
Updates to in_stock
are not allowed while active or running. Wait for the current process to finish. |
INVALID_STATE_LSF_TYPE_OR_IN_STOCK_UPDATE_NOT_ALLOWED
|
Updates to storefront type or in_stock
are not allowed at this time. Avoid updates while in_stock
or pickup
is active. |
INVALID_STATE_MISSING_MERCHANT_HOMEPAGE_URL
|
A Merchant homepage URL is required to create a conversion source. Add your homepage URL in the account settings. |
INVALID_STATE_NOT_ELIGIBLE_TO_ADD_USER_DUE_TO_ACCOUNT_TYPE
|
The user cannot be added to account {ACCOUNT_ID}
due to its type (such as child user). Refer to the Google Families guide
. |
INVALID_STATE_NOT_ELIGIBLE_TO_CLAIM_HOMEPAGE_EXEMPTED
|
The homepage for account {FORMATTED_FIELD_VALUE}
is exempted from claiming. Contact support if you believe this is an error. |
INVALID_STATE_NOT_ELIGIBLE_TO_TRIGGER_ACTION
|
The account is not eligible to trigger this action. Ensure all preconditions are met before calling this method. |
INVALID_STATE_NO_HOMEPAGE
|
The account does not have a homepage that could be claimed. Add a website URL to your account settings first. |
INVALID_STATE_ODO_UPDATE_NOT_ALLOWED
|
Updates to odo
(On Display to Order) are not allowed while active. Wait for current processes to complete. |
INVALID_STATE_OMNICHANNEL_SETTING_ABOUT_UPDATE_NOT_ALLOWED
|
Updating "About" is not allowed while active. Attempt the update when the setting is not in use. |
INVALID_STATE_PICKUP_UPDATE_NOT_ALLOWED
|
Pickup updates are not allowed while active or running. Try again later. |
INVALID_STATE_PRIMARY_DATA_SOURCE_UPDATE
|
One or more fields have invalid values for a primary data source update. Verify the data source configuration. |
INVALID_STATE_SERVICE_NOT_PENDING
|
Only services in a PENDING
state can be approved. Check the current service status. |
INVALID_STATE_SUPPLEMENTAL_DATA_SOURCE_REFERENCED_BY_PRIMARY
|
One or more fields are invalid for this supplemental data source. Ensure all values are correct for referenced feeds. |
INVALID_STATE_SUPPLEMENTAL_DATA_SOURCE_UPSERT
|
The supplemental feed cannot be deleted because it is referenced by other primary data sources. Remove references to this feed from all primary data sources before deleting. |
INVALID_STATE_TERMS_OF_SERVICE_ALREADY_SIGNED
|
The Terms of Service for this account have already been signed. No further action is required. |
INVALID_STATE_TERMS_OF_SERVICE_BUSINESS_COUNTRY_NOT_SET
|
The merchant does not have a business country set. Configure the region_code
in the business info
. |
INVALID_STATE_UNEXPECTED_OPERATION_ON_FILE_INPUT
|
File inputs cannot be added or deleted once the data source is created. Recreate the data source if a different file input configuration is needed. |
INVALID_STATE_USER_ALREADY_ADDED_TO_ACCOUNT
|
The user is already associated with account {ACCOUNT_ID}
. Verify existing users in your account. |
INVALID_STATE_USER_ALREADY_ADDED_TO_AGGREGATOR
|
The user is already added to the parent multi-client account (MCA) with ID {AGGREGATOR_ID}
. You don't need to add the user to sub-accounts separately. |
INVALID_STATE_USER_ALREADY_ADDED_TO_CSS_DOMAINS
|
The user is already added to the CSS domains with IDs {CSS_ADMIN_IDS}
. Check existing CSS administration rights. |
INVALID_STATE_USER_ALREADY_ADDED_TO_CSS_GROUP
|
The user is already added to the CSS group with ID {CSS_GROUP_ADMIN_ID}
. Review the CSS group membership. |
INVALID_STATE_USER_ALREADY_ADDED_TO_DIFFERENT_CSS_HIERARCHY
|
The user already exists in another CSS Group hierarchy. A user can only belong to one CSS hierarchy at a time. |
INVALID_STATE_USER_ALREADY_ADDED_TO_SUB_ACCOUNTS
|
The user is already added to sub-accounts with IDs {SUB_ACCOUNT_IDS}
. Review existing sub-account permissions. |
INVALID_STATE_USER_IS_LAST_ADMIN
|
You cannot delete the last administrator user of account {ACCOUNT_ID}
. Add another administrator before removing this user. |
INVALID_STORE_CODE
|
The store code {ISSUE_VALUE}
is invalid. Verify the code matches your Google Business Profile store identifier. |
INVALID_STORE_CODE_BLANK
|
The store code {ISSUE_VALUE}
is blank. Provide a non-empty store code. |
INVALID_STORE_CODE_CLOSED
|
The store {ISSUE_VALUE}
is marked as permanently closed. Verify the store status in GBP. |
INVALID_STORE_CODE_DISABLED
|
The store {ISSUE_VALUE}
is disabled. Re-enable the store in your GBP account. |
INVALID_STORE_CODE_DUPLICATED
|
The listing {ISSUE_VALUE}
is already claimed. Resolve duplicate listings in your Business Profile. |
INVALID_STORE_CODE_LEADING_ZEROS
|
The store code {ISSUE_VALUE}
has leading zeros. Ensure the code matches the exact string in your linked account. |
INVALID_STORE_CODE_NOT_FOUND
|
The store code {ISSUE_VALUE}
was not found in any accessible GBP account. Link the correct Business Profile location group. |
INVALID_STORE_CODE_SUSPENDED
|
The store {ISSUE_VALUE}
is suspended. Follow the GBP guidelines to resolve the suspension. |
INVALID_STORE_CODE_UNDER_ACCESSIBLE_GMB_ACCOUNTS
|
The store code was not found in the linked location group, but matches in another group. Use the correct location group for your linked account. |
INVALID_STORE_CODE_UNKNOWN
|
The store {ISSUE_VALUE}
is unknown. Verify the store code exists in your linked accounts. |
INVALID_STORE_CODE_UNVERIFIED
|
The store {ISSUE_VALUE}
is in an unverified state. Complete the verification process in Google Business Profile. |
INVALID_SUM_OF_LINE_ITEM_QUANTITIES_NOT_MATCH_MAPPING
|
The sum of line item quantities does not match the total quantity in the shipment mapping. Correct the quantity values in {LINE_ITEM_ID}
. |
INVALID_TERMS_OF_SERVICE_IDENTIFIER
|
The Terms of Service identifier {FIELD_VALUE}
is invalid. Use the format KIND-REGION
, such as MERCHANT_CENTER-US
. |
INVALID_TERMS_OF_SERVICE_KIND
|
The Terms of Service kind is unsupported. Refer to the ToS Kind documentation for valid values. |
INVALID_TERMS_OF_SERVICE_KIND_WITH_VALUE
|
The Terms of Service kind {FIELD_VALUE}
is invalid. Select a valid kind for this account. |
INVALID_TEST_ACCOUNT_LINKING
|
Only test accounts can be linked with other test accounts. Ensure both accounts in the relationship are production accounts or both are test accounts. |
INVALID_TIME_ZONE
|
The time zone for {FIELD_LOCATION}
is invalid: {FIELD_VALUE}
. Use a valid IANA time zone like America/Los_Angeles
. |
INVALID_TOO_MANY_REQUESTS_IN_BATCH
|
The batch request is too large. Reduce the number of entries in your batch to stay within limits. |
INVALID_TOO_MANY_REQUESTS_IN_BATCH_WITH_VALUE
|
The number of requests in this batch exceeds the maximum limit. Split your request into smaller batches. |
INVALID_TOO_MANY_SERVICES_OF_TYPE
|
You can specify at most one service of type {SERVICE_TYPE}
. Remove duplicate services from the request. |
INVALID_TRANSITION_CLAIMED_ASCENDANT
|
Account {CLAIMED_ASCENDANT}
has already claimed a parent homepage. The other account must release the domain before it can be claimed here. |
INVALID_TRANSITION_CLAIMED_DESCENDANTS
|
A subdomain has already been claimed by {CLAIMED_DESCENDANTS}
. Release the subdomains before claiming the main homepage. |
INVALID_TRANSITION_CURRENT_USER_CANNOT_CLAIM
|
The homepage cannot be claimed by the current user. Ensure the user belongs to the current Merchant Center account and is verified. |
INVALID_TRANSITION_PROGRAM_CANNOT_BE_ACTIVATED
|
The merchant is not eligible to activate this program. Review the program requirements in Merchant Center. |
INVALID_TRANSITION_PROGRAM_CANNOT_BE_ONBOARDED
|
The merchant is not eligible for onboarding this program. Verify eligibility in the programs section. |
INVALID_TRANSITION_PROGRAM_CANNOT_BE_PAUSED
|
The merchant is not eligible to pause this program. Check the program status. |
INVALID_TRANSITION_SERVICE_ALREADY_REJECTED
|
The service has already been rejected. You cannot approve a service that was already rejected. |
INVALID_TRANSITION_SERVICE_NOT_SUPPORTED
|
Service not supported: {FORMATTED_ITEM_MESSAGE}
. Correct the unmet requirements listed in the message. |
INVALID_TRANSITION_TERMS_OF_SERVICE_VERSION_ID_COUNTRY_MISMATCH
|
The Terms of Service version is for a different country. Expected country code: {EXPECTED_COUNTRY}
. |
INVALID_UNEXPECTED_FIELD
|
An unexpected field {FIELD_LOCATION}
was found in the request. Remove this field if it is not supported for this method. |
INVALID_UNEXPECTED_INPUT_TYPE
|
The input type {INPUT_TYPE}
is unexpected. Provide data in the correct format for the API. |
INVALID_UNRECOGNIZED_CAPABILITY
|
Unrecognized capability {CAPABILITY}
. Use one of the allowed capabilities: {ALLOWED_CAPABILITIES}
. |
INVALID_UNRECOGNIZED_SERVICE_TYPE
|
Unrecognized service type: {SERVICE_TYPE}
. Use a valid service type identifier. |
INVALID_UPDATE_MASK_FIELD
|
The update mask contains invalid fields: {PATHS}
. Verify the field paths match the resource schema. |
INVALID_UPDATE_MASK_ONLY_ATTRIBUTES_AND_CUSTOM_ATTRIBUTES
|
Only productAttributes
and customAttributes
are allowed in the update mask. Remove other fields from the mask. |
INVALID_UPDATE_MASK_ONLY_SUPPORTS_TOP_LEVEL_FIELDS
|
Only top-level attributes are allowed in the update mask. Avoid using sub-field paths. |
INVALID_UPDATE_SUPPLEMENTAL_DATA_SOURCE_DISALLOWED
|
You cannot perform this update on a supplemental data source. Verify the data source ID. |
INVALID_USER_INPUT
|
The user input is invalid. Check the field-specific errors in the response for details. |
INVALID_VALUE
|
The value for {FIELD_NAME}
does not match the expected format {PATTERN}
. Correct the value {FIELD_VALUE}
. |
INVALID_VALUE_AND_GROUP_VALUES_CANNOT_BE_SET_TOGETHER
|
Provide either a single value or groupValues
, but not both. Choose one method for providing data. |
INVALID_VALUE_CONTAINS_BAD_WORDS
|
The value contains banned or inappropriate words. Remove offensive language from your data. |
INVALID_VALUE_TOO_LONG
|
The provided value exceeds the maximum length. Shorten the string to fit the field limit. |
INVALID_VALUE_TOO_SHORT
|
The provided value is too short. Provide more descriptive data. |
INVALID_VALUE_WITH_FORMATTED_MESSAGE
|
The value in {FIELD_LOCATION}
is invalid: {FORMATTED_ITEM_MESSAGE}
. Correct the value based on the message. |
INVALID_VERSION_IN_NAME
|
The version number in the resource name {NAME}
is invalid. Use a valid non-negative integer for the version. |
INVALID_VERSION_NUMBER_NOT_SUPPORTED
|
This version number is not supported for updates. Omit the version or use the latest supported one. |
ITEM_NOT_FOUND
|
The resource with name {RESOURCE_NAME}
was not found. Verify the identifier and ensure the resource has been created. |
MALFORMED_BATCH_ENTRY
|
All entries in a batch request must target the same account or sub-accounts of a common MCA. Review your batch entries for consistent targeting. |
MERCHANT_IDENTITY_NON_REMOVABLE_MANAGED_BY_BUSINESS_MANAGER
|
Users managed by Business Manager cannot be updated or deleted using the API. Manage these users at //business.google.com/manager
. |
MISSING_REQUIRED_EMAIL_IN_NAME
|
The user email is missing from the resource name {NAME}
. Use the format accounts/{ACCOUNT_ID}/users/{EMAIL}
. |
MISSING_REQUIRED_EMPTY_UPDATE_MASK
|
The update mask is empty, and all modifiable fields have default values. Specify at least one field to update in the mask. |
MISSING_REQUIRED_FIELD
|
The required field {FIELD_LOCATION}
was not provided. Add the missing field to your request. |
MISSING_REQUIRED_ORDER_UPDATE_CHECKOUT_TOKEN
|
The checkout_token
is required for CONFIRMED
orders in {FIELD_LOCATION}
. Provide the token. |
MISSING_REQUIRED_ORDER_UPDATE_LINE_ITEM_STATUS
|
The line item status is required for confirmed orders. Provide the status in {FIELD_LOCATION}
. |
MISSING_REQUIRED_ORDER_UPDATE_PRICE
|
A price is required for confirmed orders in {FIELD_LOCATION}
. Provide the numeric price. |
MISSING_REQUIRED_ORDER_UPDATE_PRODUCT
|
Product information is required for confirmed orders in {FIELD_LOCATION}
. Include the product ID. |
MISSING_REQUIRED_ORDER_UPDATE_QUANTITY
|
The quantity is required for confirmed orders in {FIELD_LOCATION}
. Specify the number of items. |
MISSING_REQUIRED_ORDER_UPDATE_STATUS
|
Either the order status or all line item statuses are required. Provide at least one status update. |
MISSING_REQUIRED_ORDER_UPDATE_TOTAL_AMOUNT
|
The total amount is required for confirmed orders in {FIELD_LOCATION}
. Correct the request to include the total. |
MISSING_REQUIRED_ORDER_UPDATE_UPDATE
|
An order update or line item update is required. Include update details in your request. |
MISSING_REQUIRED_PROVIDER_SERVICE
|
At least one service (Aggregation, Management, or Comparison) must be provided. Add a valid service to the provider. |
MISSING_REQUIRED_REPEATED_FIELD
|
At least one value is required in the repeated field {FIELD_LOCATION}
. Add an entry to the list. |
MISSING_REQUIRED_SALE_PRICE_WITH_SALE_PRICE_EFFECTIVE_DATE
|
{FIELD_LOCATION}
(sale price) must be provided when an effective date is set. Add the sale price to your product data. |
MISSING_REQUIRED_SHIPPING_INFO_ESTIMATED_DELIVERY_SIGNAL
|
Missing shipping info (tracking ID/carrier) or delivery promise times. Provide either trackingId
and carrierName
, or the promise time range. |
NOT_FOUND_ACCOUNT
|
The account was not found. Verify the account ID and ensure the user has access. |
NOT_FOUND_AUTOFEEDS_SETTINGS
|
Autofeed settings are missing. Set up autofeeds correctly by following the help guide . |
NOT_FOUND_AUTOMATIC_IMPROVEMENTS
|
The automatic improvements resource was not found for account {ACCOUNT_ID}
. Verify if this feature is available for your account. |
NOT_FOUND_BILLING_ACCOUNT
|
Required billing information was not found. Set up a billing account in the Google Cloud Console. |
NOT_FOUND_CHECKOUT_SETTINGS
|
The checkoutSettings
resource {RESOURCE_NAME}
was not found. Verify the resource name. |
NOT_FOUND_DATA_SOURCE
|
The data source {DATA_SOURCE_ID}
was not found. Verify the ID in {FIELD_LOCATION}
. |
NOT_FOUND_DATA_SOURCE_BY_COUNTRY_AND_LANGUAGE
|
No data feed was found for country {COUNTRY_CODE}
and language {LANGUAGE}
. Create a feed for this region. |
NOT_FOUND_DEVELOPER_REGISTRATION
|
Developer registration not found. Register your Merchant Center ID using the registerGcp method . |
NOT_FOUND_FETCH_FILE
|
The data source is not found or does not have a file input. Add a file input to the data source. |
NOT_FOUND_FILE_UPLOAD
|
File upload not found for data source {DATA_SOURCE_ID}
. Verify that a file has been successfully uploaded. |
NOT_FOUND_GBP_ACCOUNT_FOR_EMAIL
|
No GBP account was found for {GBP_EMAIL}
. Ensure the email is correct and associated with a Business Profile. |
NOT_FOUND_ORDER
|
Order {STORE_BUILDER_ID}~{ORDER_ID}
not found for account {ACCOUNT_ID}
. Verify the order ID and account. |
NOT_FOUND_POS_STORE_CODE
|
The store code was not found. Verify the store code in your Point of Sale settings. |
NOT_FOUND_PRIMARY_DATA_SOURCE
|
The primary feed was not found. Ensure you are targeting a primary data source ID. |
NOT_FOUND_PROGRAM
|
The program of type {PROGRAM_TYPE}
was not found. Verify the program identifier. |
NOT_FOUND_PROJECT_REGISTRATION_STATE
|
Project registration not found. Register your Google Cloud project before making API calls. |
NOT_FOUND_RELATIONSHIP
|
Relationship {RELATIONSHIP}
with account {ACCOUNT_ID}
not found. Verify the relationship status. |
NOT_FOUND_RELATIONSHIP_FOR_ALIAS_UPDATE
|
Cannot update alias because no relationship exists. Create a service between these accounts first. |
NOT_FOUND_REPORT
|
No report was found for data source {DATA_SOURCE_ID}
. Verify the data source ID and ensure processing is complete. |
NOT_FOUND_SERVICE
|
Service not found: {FORMATTED_ITEM_MESSAGE}
. Verify the service configuration in {FIELD_LOCATION}
. |
NOT_FOUND_SUPPLEMENTAL_DATA_SOURCE
|
The supplemental feed was not found. Verify the ID or ensure the feed is a supplemental type. |
NOT_FOUND_TERMS_OF_SERVICE
|
Couldn't find the Terms of Service. Verify the parameters provided in the request. |
NOT_FOUND_TERMS_OF_SERVICE_VERSION
|
Version {TERMS_OF_SERVICE_VERSION_ID}
does not exist. Use a valid ToS version ID. |
NOT_FOUND_UNRECOGNIZED_REGIONAL_INVENTORY_NAME
|
Unrecognized regional inventory name: {NAME}
. Verify the inventory identifier. |
NOT_FOUND_USER
|
The user {RESOURCE_NAME}
was not found. Use the format accounts/{ID}/users/{EMAIL}
and ensure the user exists. |
NOT_FOUND_USER_OR_NOT_GAIA_USER
|
The user {USER_EMAIL}
was not found. Use a valid email associated with a Google or Workspace account. |
PERMISSION_DENIED_ABANDONED_CART_DISCOUNT
|
Access denied for account {ACCOUNT_ID}
abandoned cart rules. Ensure the user has permissions to manage discounts. |
PERMISSION_DENIED_ACCESS_DATA_SOURCE
|
Account {ACCOUNT_ID}
cannot access this data source. Verify that the data source is owned by or shared with the account. |
PERMISSION_DENIED_ACCESS_FOR_GBP_EMAIL
|
Unauthorized access for email {GBP_EMAIL}
. Authenticate with the email linked to the GBP account. |
PERMISSION_DENIED_ACCESS_RESOURCE
|
The caller lacks permission for the resource {RESOURCE_NAME}
. Verify your authentication credentials and account roles. |
PERMISSION_DENIED_ACCOUNT
|
Access to the account is denied. Ensure the authenticated user has access to the target Merchant Center account. |
PERMISSION_DENIED_ACCOUNTS
|
The caller does not have access to accounts: {ACCOUNT_IDS}
. Verify access rights for each listed account. |
PERMISSION_DENIED_ACCOUNT_ID
|
Access to account {ACCOUNT_ID}
is denied. Ensure the user has the necessary roles for this account ID. |
PERMISSION_DENIED_ACTION_FOR_CONVERSION_SOURCE_TYPE
|
Action not allowed for this conversion source type. Check permissions for conversion source {CONVERSION_SOURCE_ID}
. |
PERMISSION_DENIED_ADMIN
|
User is not an administrator of account {ACCOUNT_ID}
. Request administrator access in Merchant Center. |
PERMISSION_DENIED_CHANGE_SERVICE
|
The service is immutable and cannot be changed. Create a new service if a different configuration is needed. |
PERMISSION_DENIED_DATA_SOURCE_MANAGER
|
User lacks Data Feeds Manager access to account {ACCOUNT_ID}
. Assign the correct role in Merchant Center. |
PERMISSION_DENIED_DATA_SOURCE_READER
|
User lacks Data Feeds Reader access to account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_DIRECT_USER
|
User cannot directly access account {ACCOUNT_ID}
. Access must be granted through an MCA or directly. |
PERMISSION_DENIED_GA_PROPERTY_REQUIRES_ADMIN_ROLE
|
Administrator role is required for the Google Analytics property {GA_PROPERTY_ID}
. Ensure the user is an administrator in Google Analytics. |
PERMISSION_DENIED_INVENTORY_VALIDATION
|
Inventory validation is not possible for account {ACCOUNT_ID}
. Check account eligibility for inventory services. |
PERMISSION_DENIED_MCA_NOT_OWNER_OF
|
Merchant {MCA_ID}
does not own account {ACCOUNT_ID}
. Verify the account hierarchy. |
PERMISSION_DENIED_NOT_ALLOWLISTED_AUTHORIZED_TO_USE_PDP_PROGRAM
|
PDP program is not enabled for account {ACCOUNT_ID}
. Contact support to request enablements. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_LINK_ACCOUNT
|
Cannot link account {ACCOUNT_ID}
. This is available only to approved Shopping partners. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_LINK_BUSINESS_ACCOUNTS
|
Not authorized to link Google Business Profile accounts. Ensure your project is allowed for this feature. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_LINK_GOOGLE_ADS
|
Account is not allowed to link Google Ads accounts using filters. Contact support for allowlisting. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_LINK_YOUTUBE_CHANNEL
|
Not authorized to link YouTube channels. Ensure your account is eligible for YouTube Shopping. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_API_FOR_PROJECT
|
This API endpoint is not enabled for your Cloud project. Enable the Merchant API in the Cloud Console. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_API_FOR_PROJECT_ID
|
API not enabled for project //console.cloud.google.com?project={PROJECT_ID}
. Enable the API for the specified project ID. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_HOMEPAGE_CLAIM
|
Not authorized to use the overwrite command for claimwebsite
. Verify your project's permissions. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_ORDER_TRACKING_SIGNALS
|
Order tracking signals are not enabled for {ACCOUNT_ID}
. Contact support to enable tracking signals. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_PERFORMANCE_REPORTING
|
Not authorized to use the Search
method for performance metrics. Check your project allowlist status. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_PROMOTIONS_IN_COUNTRY
|
Promotion program is not enabled for this country. Check regional availability for promotions. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_PROMOTION_PROGRAM
|
Promotion program is not enabled for {ACCOUNT_ID}
. Sign up for the promotions program in Merchant Center. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_SHOPPING_ACTIONS
|
Not allowed for Shopping Actions: {FORMATTED_ITEM_MESSAGE}
. Verify your program status. |
PERMISSION_DENIED_NOT_ALLOWLISTED_TO_USE_V1
|
Account {FORMATTED_FIELD_VALUE}
cannot access the deprecated accountshipping
service. Use the Merchant API v1 shipping service. |
PERMISSION_DENIED_NOT_AUTHORIZED_GENERIC
|
Insufficient permissions to perform this action. Refer to the access types guide . |
PERMISSION_DENIED_NOT_ELIGIBLE_ACCOUNT_TYPE
|
This method is only accessible by {ACCOUNT_TYPES}
. Verify your account type. |
PERMISSION_DENIED_NOT_ELIGIBLE_FOR_MARKETPLACE_SELLER
|
Action not allowed for marketplace sellers. Only marketplace operators can perform this action. |
PERMISSION_DENIED_NOT_ELIGIBLE_REQUIRES_CSS_ACCOUNT
|
The account {ACCOUNT_ID}
is not a CSS ID. Ensure the ID belongs to a Comparison Shopping Service. |
PERMISSION_DENIED_NOT_ELIGIBLE_REQUIRES_MCA_ACCOUNT
|
The account {ACCOUNT_ID}
is not a multi-client account (MCA). This method is reserved for parent MCA IDs. |
PERMISSION_DENIED_NOT_ELIGIBLE_REQUIRES_MERCHANT_CENTER_ACCOUNT
|
The account {ACCOUNT_ID}
is not a Merchant Center account. Use a valid MC account ID. |
PERMISSION_DENIED_NOT_ELIGIBLE_REQUIRES_STANDALONE_ACCOUNT
|
This method can only be accessed by standalone accounts. Verify the account structure. |
PERMISSION_DENIED_NOT_ELIGIBLE_TO_USE_AUTOFEEDS
|
This account is not eligible for autofeeds. Check eligibility in the help center . |
PERMISSION_DENIED_NOT_ELIGIBLE_TO_USE_FOR_MARKETPLACE
|
Action not allowed for marketplaces. Review the marketplace policy guidelines. |
PERMISSION_DENIED_NOT_ELIGIBLE_TO_USE_IN_BUSINESS_COUNTRY
|
The business country of the account does not support this action. Check country-specific feature availability. |
PERMISSION_DENIED_NOT_ELIGIBLE_TO_USE_MARKETPLACES
|
This account is not eligible for marketplaces. Verify account settings. |
PERMISSION_DENIED_NOT_ELIGIBLE_TO_USE_METHOD_AUTOMATIC_ACCOUNT
|
Only manual accounts can access this method. Use a manual account instead. |
PERMISSION_DENIED_NOT_ELIGIBLE_TO_USE_METHOD_MANUAL_ACCOUNT
|
Only automatic accounts can access this method. Use an automatic account instead. |
PERMISSION_DENIED_NOT_ELIGIBLE_TO_USE_METHOD_MCA_ACCOUNT
|
Multi-client accounts cannot access this method. Use a sub-account instead. |
PERMISSION_DENIED_NOT_ELIGIBLE_TO_USE_METHOD_TEST_ACCOUNT
|
Test accounts are not eligible for this functionality. Use a production account for this operation. |
PERMISSION_DENIED_ORDER_READER
|
User lacks Order Reader access to account {ACCOUNT_ID}
. Assign the correct role in Merchant Center. |
PERMISSION_DENIED_PAYMENTS_READER
|
User lacks Payments Reader access to account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_PRODUCTS_MANAGER
|
User lacks Products Manager access to account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_PRODUCTS_READER
|
User lacks Products Read access to account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_PROGRAMS_MANAGER
|
User lacks permissions to manage programs for account {ACCOUNT_ID}
. Refer to the roles guide
. |
PERMISSION_DENIED_PROGRAMS_READER
|
User lacks permissions to read programs for account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_PROVIDER
|
Insufficient permissions on provider {ACCOUNT_ID}
. Verify the user's role on the provider account. |
PERMISSION_DENIED_REGISTER_SHARED_GCP_ID
|
You cannot register/unregister using shared tools like OAuth Playground. Use an OAuth token from your own Google Cloud project. |
PERMISSION_DENIED_REPORTING_MANAGER
|
User lacks Reporting Manager access to account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_RESOURCE_ACCESS
|
The caller is not authenticated for resource {RESOURCE_NAME}
. Verify your API key or OAuth token. |
PERMISSION_DENIED_SERVICE_APPROVAL
|
The calling user is not authorized to approve this service. Ensure the user has the required access rights. |
PERMISSION_DENIED_SHIPPING_MANAGER
|
User lacks permissions to manage shipping for {ACCOUNT_ID}
. Refer to roles and permissions
. |
PERMISSION_DENIED_SHIPPING_READER
|
User lacks permissions to read shipping for {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_SIGN_TERMS_OF_SERVICE
|
Only direct users of the account can sign the Terms of Service. Sign in as a direct user to sign the ToS. |
PERMISSION_DENIED_STANDARD
|
User lacks Standard access to account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_STANDARD_READER
|
User lacks Standard Read access to account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_TERMS_OF_SERVICE_MANAGER
|
User lacks ToS Manager access to account {ACCOUNT_ID}
. Assign the correct role. |
PERMISSION_DENIED_TERMS_OF_SERVICE_UNSIGNED
|
Terms of Service are not signed for account {ACCOUNT_ID}
. Review and sign the ToS in Merchant Center. |
PERMISSION_DENIED_TO_CLAIM_HOMEPAGE_CLAIMED_AT_HIGHER_LEVEL
|
The domain was claimed at a higher level, making it unavailable for claiming here. Contact the parent domain owner. |
PERMISSION_DENIED_TO_REGISTER_GCP_WITH_SERVICE_ACCOUNT
|
Google Cloud registration is not allowed for service accounts. Use a human user account for registration. |
PERMISSION_DENIED_TO_USE_ENDPOINT
|
The merchant is not allowed to use this API endpoint. Contact support to request access. |
PERMISSION_DENIED_TO_USE_FEATURE
|
Method {FIELD_LOCATION}
is disabled for this account. Review the account's allowed features for {FORMATTED_FIELD_VALUE}
. |
PERMISSION_DENIED_TO_USE_MARKET_INSIGHTS
|
Market Insights is not enabled for account {ACCOUNT_ID}
. Enable the program in Merchant Center. |
PERMISSION_DENIED_TO_USE_YOUTUBE_REPORT
|
YouTube report is not enabled for account {ACCOUNT_ID}
. Join the YouTube Shopping program. |
PERMISSION_DENIED_USE_MERCHANT_REVIEWS
|
Merchant reviews program is not enabled for account {ACCOUNT_ID}
. Refer to the reviews guide
. |
PERMISSION_DENIED_USE_PRODUCT_REVIEWS
|
Product reviews program is not enabled for account {ACCOUNT_ID}
. Refer to the product reviews guide
. |
PERMISSION_DENIED_USE_V2_API
|
The v2 API is not available for this account. Continue using the Merchant API v1. |
PERMISSION_DENIED_VERIFY_OTHER_USER
|
A user can only update their own state to VERIFIED
. The authenticated user must match the user being updated. |
QUOTA_EXCEEDED_ACCOUNTS_LIMIT_WITH_VALUE
|
User reached the limit of {LIMIT_VALUE}
accounts. Remove unnecessary accounts or request a limit increase. |
QUOTA_EXCEEDED_ADS_LINKS_PER_MERCHANT_LIMIT
|
Maximum number of Ads links reached. Remove existing links to add new ones. |
QUOTA_EXCEEDED_ADWORDS_LINKS_PER_MERCHANT_LIMIT
|
Maximum number of AdWords links reached. Consolidate your linked accounts. |
QUOTA_EXCEEDED_CONVERSION_SOURCES_LIMIT
|
Conversion sources limit exceeded. Delete unused conversion sources. |
QUOTA_EXCEEDED_DATA_SOURCE_LIMIT
|
Maximum number of data sources reached. Refer to requesting more feeds . |
QUOTA_EXCEEDED_DATA_SOURCE_LIMIT_WITH_VALUE
|
Maximum number of data sources reached. Check your current limits in the Quota guide . |
QUOTA_EXCEEDED_FREQUENT_PRODUCT_UPDATES
|
Frequent product updates limit exceeded. Continue using standard updates for non-price/inventory attributes. |
QUOTA_EXCEEDED_PHONE_NUMBER_VERIFICATION_LIMIT
|
Phone number verification limit exceeded. |
QUOTA_EXCEEDED_PHONE_VERIFICATION_RETRIES_LIMIT
|
Too many verification requests per phone number. Wait 24 hours before trying again. |
QUOTA_EXCEEDED_PRODUCT_LIMIT
|
Product limit exceeded. Refer to managing your product limit . |
QUOTA_EXCEEDED_PROMOTION_LIMIT
|
Promotion limit exceeded. Refer to promotion limits . |
QUOTA_EXCEEDED_REGION_LIMIT
|
Regions limit exceeded. Consolidate your regional configurations. |
QUOTA_EXCEEDED_RETURN_ADDRESS_LIMIT
|
Return address limit exceeded. Remove old return addresses. |
QUOTA_EXCEEDED_RETURN_POLICY_LIMIT
|
Return policy limit exceeded. Use catch-all policies where possible. |
QUOTA_EXCEEDED_SUBACCOUNTS_LIMIT
|
Maximum number of aggregation services reached. Contact support to request more sub-accounts . |
QUOTA_EXCEEDED_TOTAL_REGIONS_SIZE_LIMIT
|
Total regions size limit exceeded. Reduce the size of your regional data. |
QUOTA_EXCEEDED_USER_ACCOUNT_LIMIT
|
Account {ACCOUNT_ID}
reached its user limit of {LIMIT_VALUE}
users. Remove inactive users. |
QUOTA_EXCEEDED_USER_LIMIT
|
Maximum number of users reached. Audit your user list. |
QUOTA_EXCEEDED_YOUTUBE_CHANNEL_LINKS_LIMIT
|
Maximum YouTube channel links reached. Remove unnecessary links. |
QUOTA_REQUEST_RATE_TOO_HIGH
|
Quota per minute exceeded. Implement exponential backoff and distribute requests over a longer period. |
QUOTA_REQUEST_RATE_TOO_HIGH_FOR_FREQUENT_PRODUCT_UPDATES
|
Minute quota for frequent updates exceeded. Slow down the rate of price/inventory updates. |
QUOTA_TOO_MANY_REQUESTS
|
Daily request quota exceeded. Reduce the total number of requests per day. |
REQUEST_TOO_LARGE
|
The request is too large for attribute {FIELD_LOCATION}
. Reduce the amount of data sent for this attribute. |
REQUEST_TOO_LARGE_ATTRIBUTE_SIZE
|
The total attribute size is too large. Trim your product attributes to stay within size limits. |
REQUEST_TOO_LARGE_TOO_MANY_ATTRIBUTES
|
The request contains too many attributes. Only include necessary attributes in your request. |
VALIDATION_DYNAMIC_ISSUE
|
Validation failed: {FORMATTED_ITEM_MESSAGE}
. Fix the specific validation issue listed for {FIELD_LOCATION}
. |
