rocket
Conheça
a
API Merchant
– a sucessora oficial da API Content for Shopping.
update
Fique por dentro
dos novos recursos, correções de bugs e atualizações da API Merchant.
add_alert
Observação: a API Content for Shopping será desativada em 18 de agosto de 2026.
Erros comuns
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Estes são os erros mais comuns:
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. |
internalError
Internal error |
|---|
| Resumo | Há um problema com o back-end do Google. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Tente fazer a solicitação novamente.
Entre em contato conosco
se falhar de forma consistente. |
| Dicas de prevenção | Não relevante |
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 | 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. |
[name] The term '<term>' is not
allowed |
|---|
| Resumo | O nome contém uma palavra proibida. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Use um nome permitido.
Consulte o artigo da Central de Ajuda sobre a especificação de feed para mais informações. |
| Dicas de prevenção | Não relevante |
[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 | Não relevante |
| 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 de feed para mais informações. |
| Dicas de prevenção | Não relevante |
[storeCode] storeCode must be
'online' |
|---|
| Resumo | 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. |
[<attribute>] |
|---|
| Resumo | O item especificado nos colchetes não é válido. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Corrija a especificação do item com problema. Consulte o artigo da Central de Ajuda sobre a especificação de feed para mais informações. |
| Dicas de prevenção | Não relevante |
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 | 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.
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ção | Consulte as Dicas de manuseio recomendadas. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|---|
| Resumo | Você tem o número máximo de subcontas permitidas
para sua conta de múltiplos clientes. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Excluir subcontas
obsoletas.
Se todas as suas contas estiverem ativas,
solicite a criação de subcontas adicionais na MCA. |
| Dicas de prevenção | Não relevante |
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. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Verifique se o valor
do campo
adwords_redirect é um URL válido. |
| Dicas de prevenção | Não relevante |
[item] auth/frontend/not_claimed |
|---|
| Resumo | O URL do site do comerciante não foi reivindicado no
Merchant Center. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Reivindique o URL no
Merchant Center. O procedimento detalhado para isso está disponível na Central de Ajuda. |
| Dicas de prevenção | Não relevante |
[energy_efficiency_class]
validation/feed |
|---|
| Resumo | Especificaram energyEfficiencyClass
e
preço unitário para o mesmo produto. |
| Causas comuns | Não relevante |
| 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 | Não relevante |
[item] internal |
|---|
| Resumo | Um erro interno. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Tente fazer a solicitação novamente.
Entre em contato conosco
se falhar de forma consistente. |
| Dicas de prevenção | Não relevante |
[item_group_id] invalid_attribute |
|---|
| Resumo | Foi enviado um item com itemGroupId
e muitos valores para um atributo de variante (cor, tamanho, estampa ou material). |
| Causas comuns | Especifique mais de um tamanho para um produto ao especificar 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 | Não relevante |
[additional_image_link]
invalid_attribute |
|---|
| Resumo | Enviou mais de 10 links de imagens adicionais. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Limite o número de
links de imagens adicionais a 10. |
| Dicas de prevenção | Não relevante |
[<attribute>] invalid_character |
|---|
| Resumo | 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. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Verifique se todos os atributos obedecem à especificação do feed. Para mais informações, consulte o artigo da Central de Ajuda sobre especificação de feed. Para problemas de GTIN ou MPN, consulte o
artigo da Central de Ajuda sobre identificadores exclusivos de produto. |
| Dicas de prevenção | Não relevante |
[<attribute>]
missing_recommended / missing_required |
|---|
| Resumo | Um produto foi enviado sem um atributo obrigatório/recomendado. |
| Causas comuns | Não relevante |
| Soluções recomendadas | Inclua todos
os atributos recomendados / obrigatórios para seu produto. Consulte o artigo da Central de Ajuda sobre a especificação de feed para mais informações. |
| Dicas de prevenção | Não relevante |
[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 | Não relevante |
| Soluções recomendadas | Verifique se os URLs
dos produtos enviados correspondem ao
site
reivindicado pelo Merchant Center. |
| Dicas de prevenção | Não relevante |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 2025-08-29 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"]]
