Cotas e limites

Os recursos da API Merchant têm cotas e limites rígidos.

Observação: as cotas e os limites estão sujeitos a eliminação, redução ou alteração a qualquer momento, sem aviso prévio.

Atualizar política

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

• Só é possível atualizar os produtos duas vezes por dia.
• Só é possível atualizar as subcontas uma vez por dia.

Cotas de chamadas de método

A API Merchant ajusta automaticamente as cotas de chamadas para products e accounts com base no seu uso.

Confira como monitoramos o uso da 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, e não como 250 solicitações get.
• As cotas se aplicam ao grupo de serviços de comparação de preços (CSS), ao CSS, à conta ou às subcontas em que você se autentica ao fazer a chamada. Por exemplo, se você fizer a autenticação como uma conta avançada, as chamadas serão contabilizadas na cota da sua conta avançada. No entanto, se você fizer a autenticação como uma das suas subcontas, as chamadas serão contabilizadas na cota da subconta.

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

Verificar suas cotas

Para verificar a cota e o uso atuais de uma conta, chame quotas.list com o name da conta.

A cota automática se aplica apenas aos serviços products e accounts. Se você precisar de um aumento de cota para qualquer outro serviço, se estiver atingindo sua cota diária para os serviços products ou accounts ou se precisar de um aumento temporário para o accounts ou os produtos services, entre em contato com a gente 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 que você precisa para esses métodos
• O motivo do aumento de cota
• Se é um aumento temporário ou permanente

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

Erros

Se você exceder as cotas, receberá os seguintes erros:

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

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

Os seguintes erros não podem ser resolvidos com 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 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.

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

Recurso	Campo	Limite
shippingsettings	Serviços de frete por país (services). Frete de grupos por serviço de frete (rateGroups). Rótulos por grupo de envio (applicableShippingLabels). Subtabelas por grupo de frete (subtables). Número de linhas ou colunas em uma única tabela de taxas. Comprimento dos rótulos para envio.	20 20 30 100 150 100

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

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