O design da API Google Ads difere de uma arquitetura REST tradicional.
porque ela usa principalmente métodos personalizados, como search e mutate,.
dos métodos mais tradicionais list, get, create, update e delete.
Essas ações são expressas em URLs REST usando o mapeamento HTTP
de um : para separar o verbo personalizado do restante do URL.
Por exemplo, uma chamada de API de mutação de uma campanha usa o seguinte URL:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
Uma razão pela qual a API usa métodos personalizados é ativar o agrupamento de vários
operações em uma única solicitação de API. A semântica REST rigorosa só permite
atualizando uma campanha por vez. Um REST tradicional
update para um
campanha, por exemplo, exigiria o envio de uma solicitação PATCH HTTP por campanha
recurso.
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 (buscando muitos objetos de uma só vez) a partir da API,
a API usa um método search personalizado com uma consulta do Google Ads semelhante a SQL
Idioma.
A página Métodos comuns apresenta detalhes sobre os métodos mais usados na API Google Ads.