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](https://developers.google.com/merchant/api/guides/error-handling#error_response_structure).

[B](https://developers.google.com/merchant/api/guides/error-messages#errors-b) \| [C](https://developers.google.com/merchant/api/guides/error-messages#errors-c) \| [D](https://developers.google.com/merchant/api/guides/error-messages#errors-d) \| [E](https://developers.google.com/merchant/api/guides/error-messages#errors-e) \|
[F](https://developers.google.com/merchant/api/guides/error-messages#errors-f) \| [G](https://developers.google.com/merchant/api/guides/error-messages#errors-g) \| [I](https://developers.google.com/merchant/api/guides/error-messages#errors-i) \| [M](https://developers.google.com/merchant/api/guides/error-messages#errors-m) \|
[N](https://developers.google.com/merchant/api/guides/error-messages#errors-n) \| [P](https://developers.google.com/merchant/api/guides/error-messages#errors-p) \| [Q](https://developers.google.com/merchant/api/guides/error-messages#errors-q) \| [R](https://developers.google.com/merchant/api/guides/error-messages#errors-r) \|
[V](https://developers.google.com/merchant/api/guides/error-messages#errors-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](https://developers.google.com/merchant/api/guides/quickstart/direct-api-calls#step_1_register_as_a_developer) 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](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.users#accessright) 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](https://developers.google.com/merchant/api/reference/rest/quota_v1/accounts.limits#Scope) for valid values. |
| `INVALID_LIMIT_TYPE` | The limit type `{FIELD_VALUE}` is unsupported. Use a supported limit type from the [quota documentation](https://developers.google.com/merchant/api/reference/rest/quota_v1/accounts.limits). |
| `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](https://developers.google.com/merchant/api/reference/rest/Shared.Types/PostalAddress). |
| `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](https://developers.google.com/merchant/api/reference/rest/Shared.Types/PhoneNumber). |
| `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](https://developers.google.com/merchant/api/guides/error-handling) 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](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.shippingSettings) 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](https://support.google.com/families/answer/7103338). |
| `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](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.businessInfo/updateBusinessInfo). |
| `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 advanced account 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](https://developers.google.com/merchant/api/reference/rest/accounts_v1/TermsOfServiceKind) 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 advanced account. 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](https://support.google.com/merchants/answer/15845643). |
| `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](https://developers.google.com/merchant/api/guides/quickstart/direct-api-calls#step_1_register_as_a_developer). |
| `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 advanced account 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](https://support.google.com/merchants/answer/12160472). |
| `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 an advanced account. This method is reserved for parent advanced account 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](https://support.google.com/merchants/answer/15845643). |
| `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](https://support.google.com/merchants/answer/12160472). |
| `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](https://support.google.com/merchants/answer/12160472). |
| `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](https://support.google.com/merchants/answer/190657). |
| `PERMISSION_DENIED_USE_PRODUCT_REVIEWS` | Product reviews program is not enabled for account `{ACCOUNT_ID}`. Refer to the [product reviews guide](https://support.google.com/merchants/answer/14620705). |
| `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](https://support.google.com/merchants/contact/additional_items). |
| `QUOTA_EXCEEDED_DATA_SOURCE_LIMIT_WITH_VALUE` | Maximum number of data sources reached. Check your current limits in the [Quota guide](https://developers.google.com/merchant/api/guides/quotas-limits). |
| `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](https://support.google.com/merchants/answer/9727343). |
| `QUOTA_EXCEEDED_PROMOTION_LIMIT` | Promotion limit exceeded. Refer to [promotion limits](https://support.google.com/merchants/answer/15499922). |
| `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](https://support.google.com/merchants/contact/additional_items). |
| `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}`. |