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 de celle d'une architecture REST traditionnelle
car elle utilise principalement des méthodes personnalisées, telles que search et mutate, à la place
des méthodes list, get, create, update et delete plus traditionnelles.
Ces actions sont exprimées dans les URL REST à l'aide du mappage HTTP
d'une valeur : pour séparer le verbe personnalisé du reste de l'URL.
Par exemple, un appel d'API mutate de campagne utilise l'URL suivante:
L'API utilise des méthodes personnalisées pour permettre le traitement par lot de plusieurs
en une seule requête API. Une sémantique REST stricte ne permettrait
en ne mettant à jour qu'une seule campagne à la fois. Une requête REST traditionnelle
update en
campagne, par exemple, nécessiterait l'envoi d'une demande HTTP PATCH par campagne
ressource.
Pour regrouper plusieurs opérations dans un même corps de requête,
À la place, l'API Google Ads définit 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,
l'API utilise une méthode search personnalisée avec une requête Google Ads de type SQL
Langue.
La page Méthodes courantes présente en détail
des 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/10/16 (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/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"]]
