Confira a seguir uma lista de erros em ordem alfabética.
auth/account_access_denied
User cannot access account
<account_number>
Resumo
Emitir uma solicitação direcionada a uma conta a que o usuário autenticado não tem acesso.
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 registrou como usuário da conta no Merchant Center (Configurações > Usuários).
Dicas de prevenção
NA
User is not an administrator of
account <account_number>
Resumo
Fez 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 os 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
Tentar 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 para
uma única operação em um conjunto de solicitações em lote. Evite várias
chamadas simultâneas para a API Content com o mesmo código de comerciante e loja,
ou verifique se elas não contêm produtos sobrepostos.
internalError
Internal error
Resumo
Há um problema com o back-end do Google.
Causas comuns
NA
Soluções recomendadas
Tente fazer a solicitação novamente.
Entre em contato
se ele falhar constantemente.
Dicas de prevenção
NA
inválido
Invalid channel:
'<channel>'
Resumo
Canal inválido fornecido como parte de um ID de 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 de país inválido fornecido como parte de um ID de 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 é do formato
channel:languageCode:countryCode:offerId e se o código
do país é um código de país
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 de 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.
Tentei atualizar o preço e a disponibilidade de um
produto on-line pelo feed de inventário, mas especifiquei um valor 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
consultas de inventário.
O item que você tentou buscar, 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 apenas receber, atualizar ou excluir
itens que aparecem nela. Especifique o ID do produto no formulário
channel:languageCode:countryCode:offerId, por exemplo:
online:ru:RU:277104-ekb em vez do ID da oferta, que tem este formato: 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 ele substituiria uma entrada válida.
Causas comuns
NA
Soluções recomendadas
Verifique os outros
erros da mesma chamada e resolva-os antes de tentar inserir novamente
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 se não substituirem um produto válido. Use a flag
includeInvalidInsertedItems para
Productstatuses.list e verifique se a conta não tem
um número excessivo de produtos inválidos.
Soluções recomendadas
Verifique e
remova números excessivos de produtos inválidos, conforme mencionado acima. Além disso, especifique
datas de validade ao fazer upload de produtos. Quando a data de expiração é
alcançada, o produto é excluído automaticamente. A data de expiração padrão e máxima é 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
a subconta e a MCA têm cota de produto suficiente.
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
das solicitações.
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 o 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 esse erro ocorrer, use
estratégias de espera programadas para reduzir a
taxa de solicitação a um nível sustentável adequado.
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.
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 fazer mudanças em lote nos produtos em um período
adequado para evitar alterações rápidas em um produto várias vezes. Para atualizações de itens que podem ser representadas como
microdados
no seu site, use essa abordagem para limitar o número de chamadas
para os serviços Products ou Inventory.
Se você ainda precisar de mais chamadas diárias para um determinado método,
entre em contato com nossa equipe 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 que. Vamos trabalhar com você para aumentar sua cota.
Dicas de prevenção
Consulte as dicas de manuseio recomendadas.
too_many_failed_auths:
Too many failed authentications.
Resumo
Você está fazendo muitas solicitações em lote para contas
às quais não tem acesso.
Causas comuns
Fazer solicitações em lotes para subcontas
excluídas ou recém-criadas antes que elas fiquem
disponíveis.
Soluções recomendadas
Evite fazer chamadas
que afetem uma subconta excluída.
Dicas de prevenção
Consulte as 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
É possível incluir no máximo 10.000 entries por
solicitação custombatch, e o limite de tamanho de transferência compactado é de 32 MB.
Soluções recomendadas
Divida o lote em vários
lotes abaixo dos limites e tente novamente.
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 formatado. 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 em lote personalizada para a API
contendo uma entrada com "method": "insert", mas nenhum produto.
Causas comuns
Esquecer de mudar o método para get
ou delete.
Soluções recomendadas
Especifique um produto a ser
inserido pelo 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 ID do
produto.
Causas comuns
Esquecer de mudar o método para
insert.
Soluções recomendadas
Especifique um produto
para excluir pelo 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
das solicitações.
Causas comuns
Consulte os limites de solicitação HTTP listados nos
limites publicados. Se você exceder
esses limites, vai receber esse erro. Às vezes, há um pico
no tráfego que causa isso, ou o 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 vai reduzir o número de solicitações
HTTP feitas.
Dicas de prevenção
Quando você receber esse erro, use estratégias de espera e
de espera programática para reduzir a taxa de solicitações a um nível
sustentável adequado.
validação
[adwords_redirect]
Resumo
Um produto foi enviado com um campo adwords_redirect
que 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 só aceita
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.
[null,null,["Última atualização 2025-06-19 UTC."],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],["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"]]
