Cette page suppose que vous êtes familiarisé avec les guides du développeur Conception orientée ressources et Noms de ressources. Elle les complète avec des détails d'implémentation spécifiques à l'API Google Ads.
Conception orientée ressources
En général, l'API Google Ads suit une conception orientée ressource, modélisée sous la forme de collections de ressources adressables individuellement (les noms de l'API). Les ressources sont référencées avec leurs noms de ressources et manipulées à l'aide d'un petit ensemble de méthodes (également appelées verbes ou opérations).
Ces noms de ressources et méthodes, combinés à un préfixe de version d'API spécifique, constituent les URL de l'interface REST. Par exemple, l'URL ci-dessous peut être décomposée en composants individuels, comme indiqué dans le tableau suivant :
https://googleads.googleapis.com/v21/customers/1234567890:mutate
| Préfixe de version de l'API | Nom de ressource (relatif) | Méthode |
|---|---|---|
https://googleads.googleapis.com/v21
|
customers/1234567890
|
mutate
|
Toutes les URL REST pour une version spécifique de l'API (par exemple, v21) partagent un préfixe de version d'API commun. Le nom de la ressource et de la méthode identifient ensemble le service d'API appelé.
L'API Google Ads utilise beaucoup de méthodes personnalisées, contrairement à la plupart des API REST traditionnelles qui utilisent des méthodes REST standards telles que list, get, create, update et delete. search, searchStream et mutate sont des exemples de méthodes personnalisées dans l'API Google Ads.
Les pages suivantes fournissent plus de détails sur les noms de ressources, les méthodes de service et les conventions de dénomination JSON de l'API Google Ads pour illustrer leur utilisation conjointe afin de définir les points de terminaison de l'interface REST.