Error messages

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}.