Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Métodos de serviço

O design da API Google Ads é diferente da 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 de API muto da campanha usa o seguinte URL:

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

Um motivo 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 estrita permite somente atualizar uma campanha de cada vez. Uma REST tradicional update 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 (buscando muitos objetos de uma só vez) na 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.