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:
https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate
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.