Cotas e limites

Sua conta do comerciante e o uso da API Merchant estão sujeitos a cotas e limites.

Atualizar política

A API Merchant aplica as seguintes políticas em termos de atualizações:

• Só é possível atualizar seus produtos até duas vezes por dia. Você precisa distribuir as chamadas diárias de maneira uniforme ao longo do dia para obedecer à cota por minuto.
• Só é possível atualizar suas subcontas até duas vezes por dia.
• Só é possível chamar métodos de fonte de dados para suas subcontas, como list ou create, até duas vezes por subconta por dia.

Cotas de chamada de método

A API Merchant ajusta automaticamente as cotas de chamadas para:

• products e accounts com base no seu uso.
• datasources para contas avançadas com base no número de subcontas.

Veja como rastreamos o uso da sua cota:

• As cotas são por método. Por exemplo, o método get tem uma cota separada do método update.
• Cada solicitação é contada uma vez, independentemente do tipo. Por exemplo, contamos uma solicitação list de 250 itens uma vez, não como 250 solicitações get.
• A cota é cobrada com base no usuário que faz a solicitação de API. Se o usuário for um membro direto de uma conta avançada, a cota será cobrada no nível da conta avançada.
• Para o serviço datasources, o ajuste automático de cota só se aplica a contas avançadas com base no número de subcontas. As cotas para contas independentes e subcontas são estáticas, e os aumentos geralmente não são aceitos. Para verificar os limites de cota de datasource, use os accounts.limits métodos.
• As cotas se aplicam ao grupo de serviços de comparação de preços (CSS), CSS, conta ou subcontas em que você se autentica ao fazer a chamada. Por exemplo, se você se autenticar como uma conta avançada, as chamadas serão contadas na cota da sua conta avançada, mas se você se autenticar como uma das suas subcontas, as chamadas serão contadas na cota da subconta.

O diagrama mostra a hierarquia de grupos de CSS, CSS, contas e subcontas.

Mudanças na cota de chamada de método da API Content for Shopping

Se você usou a API Content for Shopping, observe as seguintes mudanças na cota de chamada de método na API Merchant:

• A ausência de lote personalizado não afeta o cálculo da cota. Por exemplo, uma solicitação em lote que contém 500 solicitações de inserção é cobrada como 500 solicitações de método de inserção individuais.
• A automação de cotas para contas e produtos permanece em vigor.
• Para determinar o uso e os limites atuais da cota, incluindo automação e substituições, use o método Quota.list.

Verificar suas cotas de chamada

Para verificar as cotas de chamada e o uso atuais de uma conta, chame quotas.list com o name da conta.

A cota automática se aplica aos serviços products, accounts e datasources.

• Para recursos com cotas automáticas (products, accounts e datasources para contas avançadas) : você pode solicitar apenas um aumento temporário para cenários especiais, como o lançamento em um novo mercado ou durante temporadas de compras de alto tráfego. Não aceitamos aumentos permanentes de cota para esse tipo de recurso.
• Para todos os outros recursos sem cotas automáticas:você pode solicitar aumentos de cota conforme necessário.

Use o problema Quota increase request do formulário de contato com o suporte e preencha-o com as seguintes informações:

• Seu ID do Merchant Center
• Os métodos em que você atingiu os limites de cota
• Uma estimativa do número de chamadas por dia necessárias para esses métodos
• O motivo pelo qual você precisa de um aumento de cota
• Se é um aumento temporário ou permanente

Recomendamos verificar suas cotas periodicamente para garantir que você tenha cota suficiente para sua implementação ou como sua cota é ajustada automaticamente.

Erros

Se você exceder a cota, receberá os seguintes erros:

• Por minuto: quota/request_rate_too_high
• Por dia: quota/daily_limit_exceeded

Para conferir sua cota e uso e solicitar um aumento de cota por dia ou por minuto , consulte Verificar suas cotas de chamada.

Os erros a seguir não podem ser resolvidos por aumentos automáticos de cota, e exigem que você solicite uma cota adicional de itens, feeds ou subcontas:

• too_many_items: Merchant quota exceeded
• too_many_subaccounts: Maximum number of sub-accounts reached

Limites da conta

Os accounts.limits.get e accounts.limits.list métodos permitem verificar limites em entidades no nível da conta. Você pode usar esses métodos para verificar os limites de produtos.

Para recuperar um limite de produto específico, por exemplo, para receber a cota de anúncios do EEE de uma conta, é necessário especificar o ID da conta e o ID do limite na chamada para accounts.limits.get. O ID do limite é uma combinação do tipo de limite e do escopo. Por exemplo, products~ADS_EEA para produtos que segmentam anúncios no EEE e products~ADS_NON_EEA para produtos que segmentam anúncios fora do EEE.

Confira um exemplo de solicitação para receber o limite products~ADS_EEA de uma determinada conta:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Para saber mais sobre os IDs de limite disponíveis para sua conta, use accounts.limits.list com um filtro para type="products":

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Para mais informações sobre cotas de produtos, consulte Entender as cotas no Google Merchant Center.

Limites de representação de recursos

Os limites a seguir descrevem restrições importantes para determinados valores de string e campos de matriz nas representações de recursos usadas na API Merchant. Esses limites são os mesmos para a API Merchant e o recurso correspondente no Merchant Center.

Essa lista de limites pode não estar completa. Não vamos estender esses limites.

O número de linhas ou colunas em uma tabela de taxas afeta os seguintes campos de matriz:

• Campos de matriz em rowHeaders ou columnHeaders:
  • prices[]
  • weights[]
  • numberOfItems[]
  • postalCodeGroupNames[]
  • locations[]
  • rows[]
  • cells[]