Cotas e limites

Sua conta do Merchant 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:

• É possível atualizar seus produtos até 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 seus products e accounts com base no seu uso.

Veja como rastreamos seu uso de 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, independente 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.
• As cotas se aplicam ao grupo, ao CSS, à conta ou às subcontas dos serviços de comparação de preços (CSSs) em relação aos quais 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 dessa conta. Mas 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.

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

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

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

Verificar suas cotas de chamadas

Para verificar a cota e o uso de chamadas 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 uma cota maior para qualquer outro serviço, estiver atingindo sua cota diária para os serviços products ou accounts ou precisar de um aumento temporário para os produtos accounts ou services, entre em contato 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 de você precisar de um aumento de cota
• Se o aumento é temporário ou permanente

Recomendamos verificar suas cotas periodicamente para garantir que você tenha o suficiente para sua implementação ou como elas são ajustadas automaticamente.

Erros

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

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

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

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 métodos accounts.limits.get e accounts.limits.list 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 do EEE do Google Ads de uma conta, especifique o ID da conta e o ID do limite na chamada para accounts.limits.get. O ID do limite é uma combinação do tipo 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 de 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 Noções básicas sobre 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[]