Confira abaixo uma lista de erros em ordem alfabética.
auth/account_access_denied
User cannot access account
<account_number>
Resumo
Enviou uma solicitação direcionada a uma conta que o usuário autenticado não pode acessar.
Causas comuns
Erro no ID do comerciante de destino ou esquecimento de
registrar o usuário no Merchant Center.
Soluções recomendadas
Verifique se você está segmentando a conta certa ou se registre como usuário dela no Merchant Center (Configurações > Usuários).
Dicas de prevenção
NA
User is not an administrator of
account <account_number>
Resumo
Emitiu uma solicitação para modificar uma conta em que o
usuário autenticado não tem direitos de administrador.
Causas comuns
NA
Soluções recomendadas
Defina direitos de administrador para o usuário autenticado.
Dicas de prevenção
NA
conflito
[productId] Product ID <product
id> is already modified by another entry in the same request for merchant
<merchant> and store code <store code>
Resumo
Tentou realizar várias operações conflitantes ao mesmo tempo.
Causas comuns
Um único pedido em lote contém várias operações conflitantes para o mesmo produto, ou várias operações conflitantes para o mesmo produto foram enviadas à API Content ao mesmo tempo.
Soluções recomendadas
Confira dicas de prevenção.
Dicas de prevenção
Contém todas as mudanças de um determinado produto em
uma única operação em um conjunto de solicitações em lote. Evite várias chamadas simultâneas para a API Content do mesmo comerciante e código da loja ou garanta que essas chamadas não contenham produtos sobrepostos.
Canal inválido fornecido como parte de um ID do produto.
Por exemplo: not_a_channel:en:US:sku123.
Causas comuns
NA
Soluções recomendadas
NA
Dicas de prevenção
Verifique se o ID do produto está no formato
channel:languageCode:countryCode:offerId, por exemplo:
online:en:US:sku123. Para mais informações, consulte a documentação de referência de Products.insert.
[countrycode] Invalid country code:
'<country_code>'
Resumo
Código do país inválido fornecido como parte de um ID do produto.
Por exemplo: online:en:not_a_country_code:sku123.
Causas comuns
NA
Soluções recomendadas
NA
Dicas de prevenção
Verifique se o ID do produto está no formato
channel:languageCode:countryCode:offerId e se o código do país é um
código ISO 3166 válido.
[item id] Invalid item
id: '<id>'
Resumo
ID do item inválido, por exemplo, sku123 em vez de online:en:US:sku123.
Causas comuns
Especificar um ID da oferta em vez de um ID do produto
em uma solicitação GET ou DELETE.
Soluções recomendadas
NA
Dicas de prevenção
Confira se o ID do produto está no formato
channel:languageCode:countryCode:offerId.
Tentou atualizar o preço e a disponibilidade de um
produto on-line usando o feed de inventário, mas especificou algo diferente do
valor especial online como o ID da loja no URL.
Causas comuns
NA
Soluções recomendadas
Mude o ID da loja para online no URL da solicitação.
Dicas de prevenção
Especifique online
para produtos on-line e o ID da loja para produtos locais em todas as suas
consultas de inventário.
O item que você tentou receber, atualizar ou excluir não existe.
Causas comuns
Tentar excluir um produto que não existe ou não especificar o ID do produto corretamente no URL para exclusão.
Soluções recomendadas
Receba uma lista de
produtos usando Products.list e tente receber, atualizar ou excluir
itens que aparecem nela. Especifique o ID do produto no formato
channel:languageCode:countryCode:offerId. Por exemplo:
online:ru:RU:277104-ekb em vez do ID da oferta, que tem esta aparência: 277104-ekb.
Dicas de prevenção
NA
not_inserted
The item could not be
inserted.
Resumo
Devido a outros erros, o produto não pôde ser inserido porque substituiria uma entrada válida.
Causas comuns
NA
Soluções recomendadas
Verifique os outros erros da mesma chamada e corrija-os antes de tentar reinserir as novas informações do produto.
Dicas de prevenção
NA
cota
too_many_items: Merchant
quota exceeded
Resumo
Muitos itens enviados para o Google Shopping.
Causas comuns
Os produtos que não forem validados ainda poderão ser inseridos, desde que não substituam um produto válido existente. Use a flag includeInvalidInsertedItems para Productstatuses.list e garantir que sua conta não tenha um número excessivo de produtos inválidos.
Soluções recomendadas
Verifique e remova o número excessivo de produtos inválidos, conforme mencionado acima. Além disso, especifique
datas de validade ao fazer upload de produtos. Quando a data de validade é atingida, o produto é excluído automaticamente. A data de validade padrão e máxima é de 30 dias após a inserção ou atualização do produto.
Observação: a cota de itens de uma conta de múltiplos clientes é verificada em relação ao número total de produtos em todas as subcontas. Se você receber esse erro com uma subconta, verifique se ela e sua MCA têm cota de produto suficiente.
Se você já tentou essas soluções e ainda está sem espaço para novos produtos na sua conta do Merchant Center,
peça para enviar mais itens.
Dicas de prevenção
Consulte Dicas de manuseio recomendadas.
too_many_subaccounts:
Maximum number of subaccounts reached
Resumo
Você atingiu o número máximo de subcontas permitidas para sua conta de múltiplos clientes.
request_rate_too_high:
Request rate too high. Please reduce your throughput
Resumo
As solicitações estão sendo feitas muito rapidamente. Reduza a frequência delas.
Causas comuns
Consulte as cotas por minuto listadas nos
limites publicados. Se você exceder esses limites, vai receber esse erro. Às vezes, há um pico de tráfego que causa isso, ou seu servidor se expande para um número maior de linhas de execução.
Soluções recomendadas
Reduza o total de solicitações
enviadas por minuto.
Dicas de prevenção
Quando você receber esse erro, use
estratégias de espera programática para reduzir sua
taxa de solicitação a um nível adequado e sustentável.
daily_limit_exceeded:
merchant quota exceeded
Resumo
Você está fazendo mais solicitações por dia do que o permitido para o método de serviço especificado.
Causas comuns
Consulte as cotas por dia listadas nos
limites publicados. Se você exceder esses limites, vai receber esse erro.
Soluções recomendadas
Reduza o total de solicitações enviadas por dia combinando várias mudanças em uma única solicitação sempre que possível. Considere agrupar as mudanças nos produtos em um período adequado para evitar alterações rápidas e múltiplas. Para atualizações de itens que podem ser representadas como microdados no seu site, use essa abordagem para limitar o número de chamadas aos serviços Products ou Inventory.
Se você ainda precisar de mais chamadas diárias para um determinado método, entre em contato e informe seu ID do Merchant Center, os métodos em que você está atingindo os limites de cota, uma estimativa de quantas chamadas por dia você vai precisar para esses métodos e por quê. Vamos trabalhar com você para aumentar sua cota.
Dicas de prevenção
Consulte Dicas de manuseio recomendadas.
too_many_failed_auths:
Too many failed authentications.
Resumo
Você está fazendo muitas solicitações em lote para contas a que não tem acesso.
Causas comuns
Fazer solicitações em lotes para subcontas excluídas ou recém-criadas antes que elas estejam disponíveis.
Soluções recomendadas
Evite fazer chamadas
que afetem uma subconta excluída.
Dicas de prevenção
Consulte Dicas de manuseio recomendadas.
request_too_large
Resumo
Você está enviando muitos entries por solicitação em lote ou
excedendo o limite de tamanho da solicitação custombatch.
Causas comuns
Você pode incluir no máximo 10.000 entries por solicitação de custombatch, e o limite de tamanho de transferência compactado é de 32 MB.
Soluções recomendadas
Divida o lote em vários lotes menores e tente de novo.
Dicas de prevenção
Recomendamos enviar no máximo
1.000 entradas por lote.
obrigatório
[price.value] Required parameter: price.value
Resumo
Especificou um preço sem valor. Por exemplo:
{ "currency": "USD" } em vez de
{ "value": 123, "currency": "USD" }.
Causas comuns
NA
Soluções recomendadas
Verifique se o parâmetro, aqui price, está bem formado. Por exemplo, price tem dois campos obrigatórios: value e currency.
Dicas de prevenção
NA
[product] INSERT request must specify
product
Resumo
Enviou uma solicitação de lote personalizada para a API
contendo uma entrada com "method": "insert", mas sem produto.
Causas comuns
Esquecer de mudar o método para get
ou delete.
Soluções recomendadas
Especifique um produto para
inserir usando o campo product.
Dicas de prevenção
Verifique se as entradas em lote com o método
insert especificam um produto e se as entradas em lote com o método
get ou delete especificam um ID do produto.
[productId] DELETE request must specify
productId
Resumo
Enviou uma solicitação de lote personalizada para a API
contendo uma entrada com "method": "delete", mas sem um ID
do produto.
Causas comuns
Esquecer de mudar o método para
insert.
Soluções recomendadas
Especifique um produto para excluir usando o campo productID.
Dicas de prevenção
Verifique se as entradas em lote com o método
insert especificam um produto e se as entradas em lote com o método
get ou delete especificam um ID do produto.
userRateLimitExceeded
User Rate Limit
Exceeded
Resumo
As solicitações estão sendo feitas muito rapidamente. Reduza a frequência delas.
Causas comuns
Consulte os limites de solicitações HTTP listados nos
limites publicados. Se você exceder esses limites, vai receber esse erro. Às vezes, há um pico de tráfego que causa isso, ou seu servidor se expande para um número maior de linhas de execução.
Soluções recomendadas
Reduza o total de solicitações
enviadas por minuto. Agrupar várias chamadas de método para o mesmo serviço em uma única solicitação custombatch reduz o número de solicitações HTTP feitas.
Dicas de prevenção
Quando você receber esse erro, use estratégias de espera programática e em lote para reduzir a taxa de solicitações a um nível adequado e sustentável.
validação
[adwords_redirect]
Resumo
Você enviou um produto cujo campo adwords_redirect
não é um URL válido.
Enviou uma marca, descrição ou outro atributo
como uma string que não é analisada usando a codificação de solicitação especificada.
Causas comuns
NA
Soluções recomendadas
Verifique a mensagem para
descobrir qual atributo está causando o problema e valide a codificação
de texto do valor correspondente antes de enviar novamente. A API aceita apenas caracteres UTF-8 válidos.
Dicas de prevenção
NA
[<attribute>] invalid_value
Resumo
Enviou uma cor, descrição ou outro atributo
que não é válido.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2026-07-06 UTC."],[],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]
