Limitação de taxa

A Ads API tem limites de taxa semelhantes aos da REST API v1.1, conforme documentado aqui: REST API Rate Limiting in v1.1. Diferentemente da REST API v1.1, não há um índice programático dos limites por endpoint. Os limites de taxa por endpoint e as janelas de redefinição são informados nos cabeçalhos de resposta HTTP. Todo o rate limiting na X Ads API utiliza OAuth 1.0a.

​

Limites no nível do usuário e no nível da conta de anúncio

Existem dois tipos de limites de requisições: no nível do token do usuário e no nível da conta de anúncio. Um subconjunto de endpoints está habilitado para usar limite de taxa no nível da conta de anúncio. Um token de usuário é o OAuth access token que você usa para autenticar e chamar a X Ads API. Cada token de usuário pode ter acesso a uma ou mais contas de anúncio.

Os desenvolvedores devem utilizar o limite de taxa no nível da conta de anúncio quando ele for retornado nos cabeçalhos de resposta e utilizar o limite no nível do usuário apenas quando o limite da conta de anúncio não for encontrado.

Os limites de requisições no nível do usuário são expressos por meio destes cabeçalhos: x-rate-limit-limit, x-rate-limit-remaining e x-rate-limit-reset.

Para endpoints com limite de taxa no nível da conta de anúncio habilitado, os limites de requisições são expressos por meio destes cabeçalhos: x-account-rate-limit-limit, x-account-rate-limit-remaining e x-account-rate-limit-reset.

Os limites de requisições no nível da conta de anúncio são fornecidos apenas para endpoints GET, a fim de permitir que os aplicativos sincronizem dados de entidades (como objetos de campanha ou de item de linha) a partir de um único token de usuário que acessa várias contas de anúncio. Ações de escrita não têm garantia de usar os mesmos limites de taxa no nível da conta de anúncio.

Para endpoints com limite de taxa no nível da conta de anúncio, o limite de taxa no nível do usuário é definido em um valor alto que representa uma cota global para todo o seu aplicativo. Quando disponível, o limite de taxa no nível da conta de anúncio deve ter precedência no controle do seu volume de requisições.

​

Melhores práticas

1. Salve, no seu banco de dados, o carimbo de data/hora da última sincronização e, ao solicitar dados, quando aplicável, use a opção sort_by=updated_at-desc para permitir encerrar o processo de sincronização após alcançar dados mais antigos do que o último carimbo de sincronização. Isso evitará sincronizações redundantes dos mesmos dados.

2. Solicite várias entidades em uma única requisição: alguns endpoints permitem especificar uma lista de valores separada por vírgulas para recuperar múltiplos conjuntos de dados semelhantes. Isso pode reduzir o número total de chamadas e, assim, utilizar o limite de taxa com mais eficiência.

3. Solicite o valor máximo de “count” em suas requisições: alguns endpoints, como GET accounts/:account_id/targeting_criteria, recomendam fortemente usar o valor máximo de count para retornar 1000 objetos em vez do padrão de 200.

​

Sincronização de Analytics

Consulte o Guia de Limites de Requisições de Analytics para mais informações sobre limites de requisições do endpoint de analytics.

​

FAQs

É possível aumentar os limites de requisições para uma conta de anúncios específica ou para nosso aplicativo?

Em geral, não podemos aumentar os limites de requisições; eles são definidos para dar suporte às maiores contas de anúncios. Como primeiro passo, implemente as Melhores Práticas listadas neste documento e, se os limites de requisições ainda estiverem afetando sua capacidade de escalar ou atingir objetivos de negócios, entre em contato com seus pontos de contato da X Ads API com detalhes completos sobre o caso de uso e as requisições envolvidas.

​

Escopos de limite de taxa

​

Escopos deste documento

• Categoria: todos os endpoints que se enquadram na categoria informada estão sujeitos a um único limite de taxa alocado por janela.
• Endpoint: cada endpoint possui seu próprio limite de taxa alocado, distinto por janela.

​

Tabela de limite de taxa da X Ads API

​

Limites de requisições da X Ads API

Tipo de endpoint	Escopo por endpoint ou categoria	Limite de taxa por janela de 1 minuto
Gravações (POST, PUT, DELETE)	Categoria	450
Audience	Endpoint	1500

Tipo de endpoint	Escopo por endpoint ou categoria	Limite de taxa por janela de 15 minutos
Analytics (síncrono)	Categoria	250
Leituras de Entidades Principais (Line Items, Campaigns, etc.) Outras leituras de conta (outros endpoints GET com :account_id)	Endpoint (nível de conta de anúncios) Endpoint (nível parcial de conta de anúncios)	10.000 2000
Targeting Criteria (além dos abaixo)	Categoria	400
Targeting Criteria (tv_markets, tv_shows)	Endpoint	2000
Audience Insights	Categoria	400
Keyword Insights	Categoria	500
Leituras globais (endpoints GET sem :account_id)	Endpoint	5
Conversions	Endpoint	60.000