Métodos de serviço

O design da Google Ads API é diferente de uma arquitetura REST tradicional porque ela 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 da API de mutação da campanha usa o seguinte URL:

https://googleads.googleapis.com/v16/customers/1234567890/campaigns:mutate

Uma razão para a API usar métodos personalizados é ativar o agrupamento de várias operações em uma única solicitação de API. A semântica REST rigorosa só permitiria atualizar uma campanha por vez. Um REST update tradicional para uma campanha, por exemplo, exigiria o envio de uma solicitação PATCH HTTP por recurso de campanha.

Para permitir que muitas operações sejam agrupadas em um único corpo de solicitação, a Google Ads API 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) 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 Google Ads API.