Here are the common item-level issues by error reason, with their mesasages 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}. |