Cotas e limites

A API Content do Shopping impõe cotas e limites rígidos a alguns recursos. Todas as cotas e limites estão sujeitos a eliminação, redução ou alteração a qualquer momento, sem aviso prévio.

Política de cotas

Em média, não atualize seus produtos mais de duas vezes por dia e as subcontas mais de uma vez por dia.

Cotas de chamadas de método

A API Content for Shopping ajusta automaticamente as cotas products e accounts com base no seu uso. O uso de accounts é baseado no limite de subcontas.

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.
  • Os métodos patch são contabilizados nas cotas get e update.
  • Cada chamada de método em um custombatch é contabilizada separadamente em relação à cota do método.
  • As chamadas contam para a cota da conta que você 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.

Verificar suas cotas

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

Recomendamos verificar as cotas periodicamente para garantir que você tenha cota suficiente para a implementação.

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 accounts ou produtos services, entre em contato com as seguintes informações:

  • Seu ID do Merchant Center.
  • Quais métodos atingiram os limites de cota.
  • Uma estimativa de quantas chamadas por dia você precisa para esses métodos.
  • O motivo do aumento de cota.

Erros

Se você exceder as cotas da API Content for Shopping, vai 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 Content. Esses limites são os mesmos para a API Content e o recurso correspondente no Merchant Center. Essa lista de limites pode não estar completa e não pode ser estendida.

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[]