O design da API Google Ads difere 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/v21/customers/1234567890/campaigns:mutate
Um dos motivos para a API usar métodos personalizados é permitir o agrupamento de várias operações em uma única solicitação de API. A semântica REST estrita 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 (busca de vários objetos de uma só vez) da API,
ela usa um método search personalizado com uma linguagem de consulta do Google Ads
semelhante a SQL.
A página Métodos comuns detalha os métodos mais usados na API Google Ads.