Skip to main content
A ordenação está disponível para a maioria dos endpoints de coleção da Ads API (que retornam uma lista de objetos). Dependendo do endpoint, você encontrará vários parâmetros habilitados para ordenação. A maioria dos campos retornados por esses parâmetros (exceto IDs e ENUMs) será ordenável.

Começando

Em sua requisição à API, simplesmente adicione sort_by=[attribute name]-[asc/desc] onde o atributo é um atributo válido retornado no JSON da sua requisição GET. Por exemplo, você pode usar ?name-asc para ordenar por nome alfabeticamente ou ?name-desc para ordenar em reverso.

Indo mais fundo

Abaixo está uma requisição de API de exemplo para retornar todos os line items pelo bid_amount_local_micro em ordem descendente: twurl -H ads-api.x.com "/5/accounts/k9w0oe/line\_items?sort\_by=bid\_amount\_local_micro-desc" Para o exemplo de resposta JSON completo com múltiplos line items, consulte a versão em inglês em /x-ads-api/fundamentals/sorting.