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 à l'aide de 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 modification de campagne utilise l'URL suivante:
L'API utilise des méthodes personnalisées pour regrouper plusieurs opérations dans une seule requête API. La sémantique REST stricte ne permet de mettre à jour qu'une seule campagne à la fois. Par exemple, une update REST traditionnelle à une campagne nécessiterait d'envoyer une requête HTTP PATCH par ressource de campagne.
Pour permettre de regrouper de nombreuses opérations dans un seul 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érer plusieurs objets à la fois) à partir de l'API, l'API 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/09/26 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/26 (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"]]
