Cuidado: você está vendo a documentação da interface REST da API. A maioria das nossas bibliotecas de cliente oficiais usa o gRPC. Consulte Introdução ao REST para ver mais detalhes.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-13 UTC."],[[["The Google Ads API utilizes custom methods like `search` and `mutate` instead of standard REST methods for efficiency and batch operations."],["This approach allows for updating multiple campaigns or fetching numerous objects within a single request, unlike traditional REST."],["Custom methods are expressed in REST URLs using a colon to separate the verb from the rest of the URL, for example, `https://googleads.googleapis.com/v18/customers/1234567890/campaigns:mutate`."],["Batching operations, like updating many campaigns simultaneously, are enabled through the custom `mutate` method, improving efficiency over individual requests."],["The `search` method uses a SQL-like query language for batch reads, enabling retrieval of multiple objects in one API call."]]],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"]]
