O design da API Google Ads é diferente de uma arquitetura REST tradicional,
porque usa principalmente métodos personalizados, como search
e mutate,
, em vez
dos métodos mais tradicionais list
, get
, create
, update
e delete
.
Essas ações são expressas em URLs REST usando a convenção de mapeamento HTTP
de um :
para separar o verbo personalizado do restante do URL.
Por exemplo, uma chamada de API de mutação de campanha usa o seguinte URL:
https://googleads.googleapis.com/v19/customers/1234567890/campaigns:mutate
Uma das razões pelas quais a API usa métodos personalizados é para permitir o agrupamento de várias
operações em uma única solicitação de API. A semântica REST rígida só permite atualizar uma campanha por vez. Um update
REST
tradicional para uma
campanha, por exemplo, exigiria o envio de uma solicitação HTTP PATCH por recurso
de campanha.
Para permitir que muitas operações sejam agrupadas em um único corpo de solicitação,
a API Google Ads define um método mutate
personalizado para a maioria dos recursos.
Da mesma forma, para ativar leituras em lote (buscar muitos objetos de uma só vez) da API,
ela usa um método search
personalizado com uma linguagem de consulta do Google Ads semelhante ao SQL.
A página Métodos comuns detalha os métodos mais usados na API Google Ads.