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 des URL REST à l'aide de la convention de mappage HTTP d'une : 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/v16/customers/1234567890/campaigns:mutate
L'une des raisons pour lesquelles l'API utilise des méthodes personnalisées consiste à permettre le regroupement de plusieurs opérations dans une seule requête API. La sémantique REST stricte ne permettrait de mettre à jour qu'une campagne à la fois. Par exemple, un objet update REST traditionnel à une campagne, nécessite, par exemple, d'envoyer une requête HTTP PATCH par ressource de campagne.
Pour permettre le regroupement de plusieurs opérations dans un seul corps de requête, l'API Google Ads définit à la place une méthode mutate personnalisée pour la plupart des ressources.
De même, pour activer les lectures par lots (récupérer de nombreux 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étaille les méthodes les plus fréquemment utilisées dans l'API Google Ads.