Erros comuns

Estes são os erros mais comuns:

Veja a seguir uma lista dos erros em ordem alfabética.

auth/account_access_denied

User cannot access account <account_number>
ResumoFoi emitida uma solicitação segmentando uma conta a que o usuário autenticado não tem acesso.
Causas comunsErro no ID do comerciante de destino ou esqueci de registrar o usuário no Merchant Center.
Soluções recomendadasVerifique se você está segmentando a conta certa ou se cadastre como um usuário dela no Merchant Center (Configurações > Usuários).
Dicas de prevençãoNão relevante
User is not an administrator of account <account_number>
ResumoEnvia uma solicitação para modificar uma conta em que o usuário autenticado não tem direitos de administrador.
Causas comunsNão relevante
Soluções recomendadasDefina os direitos de administrador para o usuário autenticado.
Dicas de prevençãoNã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>
ResumoTentativa de várias operações conflitantes ao mesmo tempo.
Causas comunsUma ú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 recomendadasConfira dicas de prevenção.
Dicas de prevençãoConter 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.

internalError

Internal error
ResumoHá um problema com o back-end do Google.
Causas comunsNão relevante
Soluções recomendadasTente fazer a solicitação novamente. Conte para nós no fórum se ele falhar com frequência.
Dicas de prevençãoNão relevante

inválido

Invalid channel: '<channel>'
ResumoO canal fornecido como parte do ID de um produto é inválido. Por exemplo: not_a_channel:en:US:sku123.
Causas comunsNão relevante
Soluções recomendadasNão relevante
Dicas de prevençãoVerifique 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>'
ResumoCódigo de país inválido fornecido como parte de um ID de produto. Por exemplo: online:en:not_a_country_code:sku123.
Causas comunsNão relevante
Soluções recomendadasNão relevante
Dicas de prevençãoVerifique 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>'
ResumoO código do item é inválido. Por exemplo, sku123 em vez de online:en:US:sku123.
Causas comunsEspecificar um ID de oferta em vez de um ID de produto em uma solicitação GET ou DELETE.
Soluções recomendadasNão relevante
Dicas de prevençãoVerifique se o ID do produto está no formato channel:languageCode:countryCode:offerId.
[name] The term '<term>' is not allowed
ResumoO nome contém uma palavra proibida.
Causas comunsNão relevante
Soluções recomendadasUse um nome permitido. Para mais informações, consulte o artigo da Central de Ajuda sobre especificação de feed.
Dicas de prevençãoNão relevante
[price.currency] Please use a currency that is supported in the target country
ResumoEspecificou uma moeda que não está disponível no país de destino.
Causas comunsNão relevante
Soluções recomendadasVerifique se a moeda e o país estão especificados corretamente. Consulte a seção sobre price no artigo da Central de Ajuda sobre a especificação do feed para saber mais.
Dicas de prevençãoNão relevante
[storeCode] storeCode must be 'online'
ResumoTentativa de atualizar o preço e a disponibilidade de um produto on-line por meio do feed de inventário, mas especificou algo diferente do valor especial online como o ID da loja no URL.
Causas comunsNão relevante
Soluções recomendadasMude o ID da loja para online no URL da solicitação.
Dicas de prevençãoEspecifique 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.
[<attribute>]
ResumoO item especificado nos colchetes não é válido.
Causas comunsNão relevante
Soluções recomendadasCorrija a especificação do item problemático. Para saber mais, consulte o artigo da Central de Ajuda sobre especificação do feed.
Dicas de prevençãoNão relevante

notFound

Item not found
ResumoO item que você tentou receber, atualizar ou excluir não existe.
Causas comunsTentar excluir um produto que não existe ou não especificar o ID do produto corretamente no URL para exclusão.
Soluções recomendadasAcesse uma lista de produtos usando Products.list e tente apenas receber, atualizar ou excluir os itens que aparecem nesse local. 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çãoNão relevante

not_inserted

The item could not be inserted.
ResumoDevido a outros erros, não foi possível inserir o produto porque isso substituiria uma entrada válida.
Causas comunsNão relevante
Soluções recomendadasVerifique os outros erros da mesma chamada e resolva-os antes de tentar reinserir as novas informações do produto.
Dicas de prevençãoNão relevante

quota

too_many_items: Merchant quota exceeded
ResumoMuitos itens enviados para o Google Shopping.
Causas comunsOs produtos que não forem validados ainda poderão ser inseridos se não substituirem um produto válido atual. Use a sinalização includeInvalidInsertedItems para Productstatuses.list e garanta que sua conta não tenha um número excessivo de produtos inválidos.
Soluções recomendadas

Verifique e remova um número excessivo de produtos inválidos, conforme mencionado acima. Além disso, especifique datas de validade ao fazer o upload dos produtos. Quando a data de validade chega, o produto é excluído automaticamente. Lembre-se de que 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 é comparada com o 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.

Se você já tentou essas soluções e ainda está ficando sem espaço para novos produtos na sua conta do Merchant Center, solicite a capacidade de enviar mais itens na sua conta.

Dicas de prevençãoConsulte Dicas de gerenciamento recomendado.
too_many_subaccounts: Maximum number of subaccounts reached
ResumoVocê tem o número máximo de subcontas permitidas para sua conta de múltiplos clientes.
Causas comunsNão relevante
Soluções recomendadas

Exclua subcontas obsoletas.

Se todas as suas contas estiverem ativas, solicite a criação de mais subcontas na sua MCA.

Dicas de prevençãoNão relevante
request_rate_too_high: Request rate too high. Please reduce your throughput
ResumoAs solicitações estão sendo feitas muito rápido. Reduza a frequência delas.
Causas comunsConsulte as cotas por minuto listadas nos limites publicados. Se você exceder esses limites, 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 recomendadasReduza o total de solicitações enviadas por minuto.
Dicas de prevençãoQuando você receber esse erro, use estratégias programáticas de espera para reduzir a taxa de solicitação a um nível sustentável adequado.
daily_limit_exceeded: merchant quota exceeded
ResumoVocê está fazendo mais do que o número permitido de solicitações por dia para o método de serviço especificado.
Causas comunsConsulte as cotas por dia listadas nos limites publicados. Se você exceder esses limites, receberá esse 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. Considere fazer mudanças em lotes nos produtos durante um período apropriado para evitar alterar rapidamente um produto várias vezes. Para atualizações de itens que podem ser representadas como microdados no seu site, considere usar 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 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 o motivo. Trabalharemos com você para aumentar sua cota.

Dicas de prevençãoConsulte Dicas de gerenciamento recomendado.
too_many_failed_auths: Too many failed authentications.
ResumoVocê está fazendo muitas solicitações em lote de contas às quais não tem acesso.
Causas comunsFazer solicitações em lotes para subcontas que foram excluídas ou para subcontas recém-criadas antes que elas fiquem disponíveis.
Soluções recomendadasEvite fazer chamadas que afetem uma subconta excluída.
Dicas de prevençãoConsulte Dicas de gerenciamento recomendado.
request_too_large
ResumoVocê está enviando muitos entries por solicitação em lote ou excedendo o limite de tamanho de solicitação de custombatch.
Causas comunsVocê pode incluir no máximo 10.000 entries por solicitação de custombatch, e o limite de tamanho da transferência compactada é de 32 MB.
Soluções recomendadasDivida o lote em vários que estão abaixo dos limites e tente novamente.
Dicas de prevençãoRecomendamos enviar no máximo 1.000 entradas por lote.

obrigatório

[price.value] Required parameter: price.value
ResumoEspecificaram um preço sem valor. Por exemplo: { "currency": "USD" } em vez de { "value": 123, "currency": "USD" }.
Causas comunsNão relevante
Soluções recomendadasVerifique se o parâmetro, aqui price, está bem formado. Por exemplo, price tem dois campos obrigatórios: value e currency.
Dicas de prevençãoNão relevante
[product] INSERT request must specify product
ResumoEnviou uma solicitação em lote personalizada para a API com uma entrada com "method": "insert", mas nenhum produto.
Causas comunsEsquecer de alterar o método para get ou delete.
Soluções recomendadasEspecifique um produto para inserir no campo product.
Dicas de prevençãoVerifique se as entradas em lote com o método insert especificam um produto e as entradas em lote com o método get ou delete especificam um ID do produto.
[productId] DELETE request must specify productId
ResumoEnviou uma solicitação em lote personalizada para a API com uma entrada com "method": "delete", mas sem ID do produto.
Causas comunsEsquecer de mudar o método para insert.
Soluções recomendadasEspecifique um produto a ser excluído no campo productID.
Dicas de prevençãoVerifique se as entradas em lote com o método insert especificam um produto e as entradas em lote com o método get ou delete especificam um ID do produto.

userRateLimitExceeded

User Rate Limit Exceeded
ResumoAs solicitações estão sendo feitas muito rápido. Reduza a frequência delas.
Causas comunsConsulte os limites de solicitação HTTP listados nos limites publicados. Se você exceder esses limites, 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 recomendadasReduza 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 reduzirá o número de solicitações HTTP feitas.
Dicas de prevençãoQuando você receber esse erro, use estratégias de retirada em lote e programáticas para reduzir a taxa de solicitação a um nível sustentável adequado.

da política.

[adwords_redirect]
ResumoProduto enviado cujo campo adwords_redirect não é um URL válido.
Causas comunsNão relevante
Soluções recomendadasVerifique se o valor do campo adwords_redirect é um URL válido.
Dicas de prevençãoNão relevante
[item] auth/frontend/not_claimed
ResumoO URL do site do comerciante não foi reivindicado no Merchant Center.
Causas comunsNão relevante
Soluções recomendadasReivindique o URL no Merchant Center. O procedimento detalhado para fazer isso está disponível na Central de Ajuda.
Dicas de prevençãoNão relevante
[energy_efficiency_class] validation/feed
ResumoEspecificou energyEfficiencyClass e o preço unitário para o mesmo produto.
Causas comunsNão relevante
Soluções recomendadasEspecifique apenas a classe de eficiência energética ou o preço unitário, não ambos.
Dicas de prevençãoNão relevante
[item] internal
ResumoUm erro interno.
Causas comunsNão relevante
Soluções recomendadasTente fazer a solicitação novamente. Conte sobre isso no fórum se ocorrer falhas frequentes.
Dicas de prevençãoNão relevante
[item_group_id] invalid_attribute
ResumoFoi enviado um item com itemGroupId e muitos valores para um atributo variante (cor, tamanho, estampa ou material).
Causas comunsEspecificar mais de um tamanho para um produto ao especificar um ID do grupo de itens.
Soluções recomendadasEnvie um produto diferente para cada valor de um determinado atributo de variante, como size.
Dicas de prevençãoNão relevante
[additional_image_link] invalid_attribute
ResumoEnviou mais de 10 links de imagens adicionais.
Causas comunsNão relevante
Soluções recomendadasLimite o número de links de imagens adicionais a 10.
Dicas de prevençãoNão relevante
[<attribute>] invalid_character
ResumoEnviou uma marca, descrição ou outro atributo como uma string que não analisa usando a codificação de solicitação especificada.
Causas comunsNão relevante
Soluções recomendadasVerifique a mensagem para descobrir qual atributo está causando o problema e valide a codificação de texto do valor correspondente antes de reenviar. A API aceita apenas caracteres UTF-8 válidos.
Dicas de prevençãoNão relevante
[<attribute>] invalid_value
ResumoEnviou uma cor, descrição ou outro atributo que não é válido.
Causas comunsNão relevante
Soluções recomendadasPara garantir que todos os atributos obedeçam à especificação de feed, consulte o artigo da Central de Ajuda sobre especificação de feed para mais informações. Para problemas de GTIN ou MPN, consulte o artigo Identificadores exclusivos de produto da Central de Ajuda.
Dicas de prevençãoNão relevante
[<attribute>] missing_recommended / missing_required
ResumoEnviou um produto sem um atributo obrigatório/recomendado.
Causas comunsNão relevante
Soluções recomendadasInclua todos os atributos recomendados / obrigatórios para seu produto. Para mais informações, consulte o artigo da Central de Ajuda sobre especificação de feed.
Dicas de prevençãoNão relevante
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
ResumoEnviou um produto com um URL de base diferente do URL reivindicado pela conta do Merchant Center.
Causas comunsNão relevante
Soluções recomendadasVerifique se os URLs dos produtos enviados correspondem ao site reivindicado pelo Merchant Center.
Dicas de prevençãoNão relevante