Confira a seguir uma lista de erros em ordem alfabética.
auth/account_access_denied
User cannot access account
<account_number>
Resumo
Foi enviada uma solicitação direcionada a uma conta que o usuário autenticado não tem acesso.
Causas comuns
Erro no ID do comerciante de destino ou você esqueceu de
registrar o usuário no Merchant Center.
Soluções recomendadas
Verifique se você está
segmentando a conta certa ou registre-se como usuário dela
no Merchant Center
(Configurações > Usuários).
Dicas de prevenção
Não relevante
User is not an administrator of
account <account_number>
Resumo
Solicitação enviada para modificar uma conta em que o usuário autenticado não tem direitos de administrador.
Causas comuns
Não relevante
Soluções recomendadas
Defina os direitos de administrador do usuário autenticado.
Dicas de prevenção
Não relevante
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
Tentei várias operações conflitantes ao mesmo
tempo.
Causas comuns
Uma única solicitação 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 as dicas de
prevenção.
Dicas de prevenção
Conter todas as alterações de um determinado produto em
uma única operação em um conjunto em lote de solicitações. Evite várias chamadas simultâneas à API Content para o 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
Não relevante
Soluções recomendadas
Não relevante
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 para 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
Não relevante
Soluções recomendadas
Não relevante
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 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 de produto em uma solicitação GET ou DELETE.
Soluções recomendadas
Não relevante
Dicas de prevenção
Verifique 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 por meio do feed de inventário, mas especificaram algo diferente do
valor especial online como o ID da loja no URL.
Causas comuns
Não relevante
Soluções recomendadas
Altere 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 disponíveis na loja física em todas as
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
Acesse uma lista de
produtos que usam Products.list e tente apenas acessar, atualizar ou excluir
os itens que aparecem lá. 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
Não relevante
not_inserted
The item could not be
inserted.
Resumo
Devido a outros erros, não foi possível inserir o produto, já que isso substituiria uma entrada válida.
Causas comuns
Não relevante
Soluções recomendadas
Verifique os outros
erros da mesma chamada e resolva-os antes de tentar reinserir
as novas informações do produto.
Dicas de prevenção
Não relevante
cota
too_many_items: Merchant
quota exceeded
Resumo
Muitos itens foram enviados ao Google Shopping.
Causas comuns
Os produtos que não forem validados ainda poderão ser
inseridos se não substituirem um produto válido atual. 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 o número excessivo de produtos inválidos, conforme mencionado acima. Além
disso, especifique as
datas de validade ao fazer upload dos produtos. Quando a data de validade chega, 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 produtos suficiente.
request_rate_too_high:
Request rate too high. Please reduce your throughput
Resumo
As solicitações estão sendo feitas muito rápido. Reduza a frequência.
Causas comuns
Consulte as cotas por minuto listadas nos limites publicados. Se você exceder esses limites, vai receber essa mensagem de 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.
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 sustentável adequado.
daily_limit_exceeded:
merchant quota exceeded
Resumo
Você está fazendo mais do que o número permitido de
solicitações por dia 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 essa mensagem de erro.
Soluções recomendadas
Reduza o total de solicitações enviadas por dia combinando várias alterações em uma única solicitação, quando possível. Faça alterações em lote nos produtos durante um período
adequado para evitar mudanças rápidas de 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 conosco e informe
seu ID do Merchant Center, em quais métodos você está atingindo os limites de cota,
uma estimativa de quantas chamadas por dia serão necessárias para esses métodos e
por quê. Trabalharemos 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 de contas a que você 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 de solicitação de 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 compactada é de 32 MB.
Soluções recomendadas
Divida o lote em vários
que estão abaixo dos limites e tente novamente.
Dicas de prevenção
Recomendamos enviar no máximo
1.000 entradas por lote.
de provisionamento.
[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
Não relevante
Soluções recomendadas
Verifique se o
parâmetro, aqui
price, está correto. Por exemplo, price tem dois campos obrigatórios: value e currency.
Dicas de prevenção
Não relevante
[product] INSERT request must specify
product
Resumo
Enviou uma solicitação em lote personalizada para a API
com uma entrada com "method": "insert", mas sem produto.
Causas comuns
Esquecer o método de mudança para get
ou delete.
Soluções recomendadas
Especifique um produto a ser inserido pelo campo product.
Dicas de prevenção
As entradas em lote com o método
insert precisam especificar um produto, e as entradas com o método
get ou delete especificam um ID do produto.
[productId] DELETE request must specify
productId
Resumo
Enviou uma solicitação em lote personalizada para a API com uma entrada com "method": "delete", mas sem ID do produto.
Causas comuns
Esqueceu de mudar o método para
insert.
Soluções recomendadas
Especifique um produto
a ser excluído no campo productID.
Dicas de prevenção
As entradas em lote com o método
insert precisam especificar um produto, e as entradas 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 rápido. Reduza a frequência.
Causas comuns
Consulte os limites de solicitação HTTP listados nos limites publicados. Se você exceder esses limites, vai receber essa mensagem de 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 diminuirá o número de solicitações HTTP realizadas.
Dicas de prevenção
Quando você receber esse erro, use estratégias de espera programática e em lote para reduzir sua taxa de solicitação a um nível sustentável adequado.
da política.
[adwords_redirect]
Resumo
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 pode ser analisada usando a codificação de solicitação especificada.
Causas comuns
Não relevante
Soluções recomendadas
Verifique a mensagem para
descobrir qual atributo está causando o problema e, em seguida, valide a codificação
de texto do valor correspondente antes de reenviar. A API aceita apenas caracteres UTF-8 válidos.
Dicas de prevenção
Não relevante
[<attribute>] invalid_value
Resumo
Enviou uma cor, uma descrição ou outro atributo
invá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 2024-07-03 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."]]],[]]
