Erros comuns

Estes são os erros mais comuns:

• notFound: item não encontrado.
• not_inserted: não foi possível inserir o item.
• [link] validation/invalid_value for <destinations>: Os URLs não pertencem ao seu site.
• quota/too_many_items::a cota do comerciante foi excedida.

Confira abaixo uma lista de erros em ordem alfabética.

Observação: para problemas de qualidade de dados ou suspensões de conta, que são separados da API Content for Shopping, consulte Entender a restrição no nível da conta para violações de dados de produtos. Também é possível ver solicitações errôneas no painel de APIs.

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.

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 com nossa equipe se o problema persistir.
Dicas de prevenção	NA

inválido

Invalid channel: '<channel>'
Resumo	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.
[name] The term '<term>' is not allowed
Resumo	O nome contém uma palavra proibida.
Causas comuns	NA
Soluções recomendadas	Use um nome permitido. Consulte o artigo da Central de Ajuda sobre especificação de feeds para mais informações.
Dicas de prevenção	NA
[price.currency] Please use a currency that is supported in the target country
Resumo	Especificou uma moeda que não está disponível no país de destino.
Causas comuns	NA
Soluções recomendadas	Verifique se a moeda e o país estão especificados corretamente. Consulte a seção sobre price no artigo da Central de Ajuda sobre especificação do feed para mais informações.
Dicas de prevenção	NA
[storeCode] storeCode must be 'online'
Resumo	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.
[<attribute>]
Resumo	O item especificado entre colchetes não é válido.
Causas comuns	NA
Soluções recomendadas	Corrija a especificação do item com problema. Consulte o artigo da Central de Ajuda sobre especificação do feed para mais informações.
Dicas de prevenção	NA

notFound

Item not found
Resumo	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.
Causas comuns	NA
Soluções recomendadas	Excluir subcontas obsoletas. Se todas as suas contas estiverem ativas, você poderá solicitar a capacidade de criar outras subcontas na sua MCA.
Dicas de prevenção	NA
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.
Causas comuns	NA
Soluções recomendadas	Confira se o valor do campo adwords_redirect é um URL válido.
Dicas de prevenção	NA
[item] auth/frontend/not_claimed
Resumo	O URL do site do comerciante não foi reivindicado no Merchant Center.
Causas comuns	NA
Soluções recomendadas	Reivindique o URL no Merchant Center. O procedimento detalhado para fazer isso está disponível na Central de Ajuda.
Dicas de prevenção	NA
[energy_efficiency_class] validation/feed
Resumo	Especificou energyEfficiencyClass e preço unitário para o mesmo produto.
Causas comuns	NA
Soluções recomendadas	Especifique apenas a classe de eficiência energética ou o preço unitário, não ambos.
Dicas de prevenção	NA
[item] internal
Resumo	Um erro interno.
Causas comuns	NA
Soluções recomendadas	Tente fazer a solicitação novamente. Entre em contato com nossa equipe se ele falhar com frequência.
Dicas de prevenção	NA
[item_group_id] invalid_attribute
Resumo	Enviou um item com itemGroupId e muitos valores para um atributo de variante (cor, tamanho, estampa ou material).
Causas comuns	Especificar mais de um tamanho para um produto ao mesmo tempo em que especifica um ID do grupo de itens.
Soluções recomendadas	Envie um produto diferente para cada valor de um determinado atributo de variante, como size.
Dicas de prevenção	NA
[additional_image_link] invalid_attribute
Resumo	Enviou mais de 10 links de imagens adicionais.
Causas comuns	NA
Soluções recomendadas	Limite o número de links de imagens adicionais a 10.
Dicas de prevenção	NA
[<attribute>] invalid_character
Resumo	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.
Causas comuns	NA
Soluções recomendadas	Verifique se todos os atributos obedecem à especificação do feed. Consulte o artigo da Central de Ajuda sobre especificação do feed para mais informações. Para problemas com GTIN ou MPN, consulte o artigo da Central de Ajuda Identificadores exclusivos de produto.
Dicas de prevenção	NA
[<attribute>] missing_recommended / missing_required
Resumo	Você enviou um produto sem um atributo obrigatório/recomendado.
Causas comuns	NA
Soluções recomendadas	Inclua todos os atributos recomendados / obrigatórios para seu produto. Consulte o artigo da Central de Ajuda sobre a especificação do feed para mais informações.
Dicas de prevenção	NA
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
Resumo	Enviou um produto com um URL base diferente do URL reivindicado pela conta do Merchant Center.
Causas comuns	NA
Soluções recomendadas	Verifique se os URLs dos produtos enviados correspondem ao site reivindicado pelo Merchant Center.
Dicas de prevenção	NA