Cotas e limites

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

Observação: as cotas e os limites estão sujeitos a eliminação, redução ou mudança 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 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 uma vez por dia.

Importante: A cota de chamadas diárias geralmente é definida como duas vezes o número de cotas de ofertas que o comerciante tem e não está estritamente relacionada a atualizações de um único produto.

Cotas de chamada de método

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

Confira 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 conta 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 de serviços de comparação de preços (CSSs), ao CSS, à conta ou às 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 contabilizadas na cota da sua conta avançada. No entanto, se você se autenticar como uma das suas subcontas, as chamadas serão contabilizadas na cota da subconta.

O diagrama mostra a hierarquia de grupos de CSSs, CSSs, 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 lotes personalizados 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.

Observação: Para o método accounts.list, o uso de cotas e limites é cobrado para cada usuário, e não para o ID do Merchant Center ou o ID da conta avançada. Para listar subcontas, use o método accounts.listSubaccounts, que é mais adequado para esse caso de uso.

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 só se aplica aos serviços products e accounts. Se você precisar de uma cota maior para qualquer outro serviço, atingir sua cota diária para os products ou accounts serviços ou precisar de um aumento temporário para os accounts ou produtos services, entre em contato conosco 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 do EEE de anúncios 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 do limite. 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.

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

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