Hiérarchie des noms
Les noms de ressources utilisés dans l'API Google Ads sont hiérarchiques et reflètent l'organisation des entités dans Google Ads. Presque toutes les ressources sont des sous-ressources
de la Customer
ressource, ce qui signifie que presque tous les appels d'API doivent cibler un
compte Google Ads spécifique. Par exemple, les campagnes, les groupes d'annonces, les annonces et les mots clés sont tous des sous-ressources d'une ressource client racine.
| Ressource | Nom de la ressource |
|---|---|
| Client | customers/1234567890
|
| Campagne | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
ID de ressource
Les entités Google Ads (clients, campagnes, etc.) sont référencées par leur nom de ressource dans l'ensemble de l'API. Toutefois, il est important de noter que les noms de ressources eux-mêmes peuvent avoir des ID de ressources numériques uniquesqui identifient chaque objet dans la hiérarchie. Dans ce cas, il peut être utile d'analyser le nom de ressource pour extraire ces ID de ressources et en assembler un nouveau.
Par exemple, examinez le nom de ressource AdGroupAd du tableau précédent :
customers/1234567890/adGroupAds/54321098765~2109876543210
Il peut être divisé en ses ID de ressources individuels (séparés par ID de collection) comme suit :
| Composants du nom de ressource | |||||||
|---|---|---|---|---|---|---|---|
| ID de ressource |
|
||||||
| ID de collection |
|
||||||
L'analyse des ID individuels vous permet de dériver de nouveaux noms de ressources pour référencer
le client de l'annonce du groupe d'annonces (customers/1234567890) ou son groupe d'annonces
(customers/1234567890/adGroupAds/54321098765).
Identifiants des objets partagés
La plupart des objets de l'API sont associés à un seul client Google Ads spécifique. Toutefois, certains types d'objets peuvent être partagés entre plusieurs comptes. En pratique, il s'agit d'éléments tels que les listes de mots clés à exclure ou les actions de conversion multicompte, qui sont généralement créés par des administrateurs, puis partagés avec de nombreux comptes client.
Les noms de ressources de ces objets diffèrent selon le compte auquel vous envoyez un appel d'API.
Exemple : Actions de conversion multicompte
Supposons que le compte administrateur 987-654-3210 partage une action de conversion multicompte avec l'un de ses comptes client 123-456-7890 :
Un appel d'API au compte administrateur pour, par exemple, mettre à jour la période d'analyse de l'action de conversion référencerait l'objet partagé à l'aide du nom de ressource : customers/9876543210/conversionActions/257733534.
Un appel d'API au compte client pour activer l'action de conversion partagée la référencerait à l'aide du nom de ressource : customers/1234567890/conversionActions/257733534.
Il s'agit de la même action de conversion sous-jacente, mais son nom de ressource est relatif au compte utilisé pour y accéder.