Attention:Vous consultez la documentation de l'interface REST de l'API. La plupart de nos bibliothèques clientes officielles utilisent gRPC. Pour en savoir plus, consultez la
présentation de REST.
Méthodes de service
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La conception de l'API Google Ads diffère d'une architecture REST traditionnelle, car elle utilise principalement des méthodes personnalisées, telles que search et mutate,, au lieu des méthodes plus traditionnelles list, get, create, update et delete.
Ces actions sont exprimées dans les URL REST en utilisant la convention de mise en correspondance HTTP d'un : pour séparer le verbe personnalisé du reste de l'URL.
Par exemple, un appel d'API de mutation de campagne utilise l'URL suivante :
https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate
L'une des raisons pour lesquelles l'API utilise des méthodes personnalisées est de permettre le regroupement de plusieurs opérations dans une seule requête API. La sémantique REST stricte n'autoriserait la mise à jour que d'une seule campagne à la fois. Une requête REST update traditionnelle envoyée à une campagne, par exemple, nécessiterait l'envoi d'une requête HTTP PATCH par ressource de campagne.
Pour permettre de regrouper plusieurs opérations dans un même corps de requête, l'API Google Ads définit plutôt une méthode mutate personnalisée pour la plupart des ressources.
De même, pour activer les lectures par lot (récupération de plusieurs objets à la fois) à partir de l'API, celle-ci utilise une méthode search personnalisée avec un langage de requête Google Ads de type SQL.
La page Méthodes courantes décrit en détail les méthodes les plus fréquemment utilisées dans l'API Google Ads.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eThe Google Ads API utilizes custom methods like \u003ccode\u003esearch\u003c/code\u003e and \u003ccode\u003emutate\u003c/code\u003e instead of standard REST methods for efficiency and batch operations.\u003c/p\u003e\n"],["\u003cp\u003eThis approach allows for updating multiple campaigns or fetching numerous objects within a single request, unlike traditional REST.\u003c/p\u003e\n"],["\u003cp\u003eCustom methods are expressed in REST URLs using a colon to separate the verb from the rest of the URL, for example, \u003ccode\u003ehttps://googleads.googleapis.com/v18/customers/1234567890/campaigns:mutate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eBatching operations, like updating many campaigns simultaneously, are enabled through the custom \u003ccode\u003emutate\u003c/code\u003e method, improving efficiency over individual requests.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esearch\u003c/code\u003e method uses a SQL-like query language for batch reads, enabling retrieval of multiple objects in one API call.\u003c/p\u003e\n"]]],["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"],null,["# Service Methods\n\nThe design of the Google Ads API differs from a traditional REST architecture\nbecause it primarily uses custom methods, such as `search` and `mutate,` instead\nof the more traditional `list`, `get`, `create`, `update`, and `delete` methods.\nThese actions are expressed in REST URLs by using the [HTTP mapping](https://cloud.google.com/apis/design/custom_methods#http_mapping)\nconvention of a `:` to separate the custom verb from the rest of the URL.\n\nFor example, a campaign mutate API call uses the following URL: \n\n https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate\n\nOne reason that the API uses custom methods is to enable batching of multiple\noperations into a single API request. Strict REST semantics would only allow\nupdating one campaign at a time. A traditional REST\n[`update`](https://cloud.google.com/apis/design/standard_methods#update) to a\ncampaign, for example, would require sending one HTTP PATCH request per campaign\nresource.\n\nTo allow many operations to be bundled together within a single request body,\nthe Google Ads API instead defines a custom `mutate` method for most resources.\nSimilarly, to enable batch reads (fetching many objects at once) from the API,\nthe API uses a custom `search` method with a SQL-like [Google Ads Query\nLanguage](/google-ads/api/docs/query/overview).\n\nThe [Common methods](/google-ads/api/rest/common/overview) page goes into detail on\nthe most frequently used methods in the Google Ads API."]]
