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