Méthodes de service

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 en utilisant 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 mutation de campagne utilise l'URL suivante :

https://googleads.googleapis.com/v21/customers/1234567890/campaigns:mutate

L'une des raisons pour lesquelles l'API utilise des méthodes personnalisées est de permettre le regroupement de plusieurs opérations dans une seule requête API. La sémantique REST stricte n'autoriserait la mise à jour que d'une seule campagne à la fois. Une requête REST update traditionnelle envoyée à une campagne, par exemple, nécessiterait l'envoi d'une requête HTTP PATCH par ressource de campagne.

Pour permettre de regrouper plusieurs opérations dans un même 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ération de plusieurs 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écrit en détail les méthodes les plus fréquemment utilisées dans l'API Google Ads.