Métodos de serviço
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 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:
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.
[[["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-10-16 UTC."],[],["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"]]
