Hiérarchie des noms
Les noms de ressources utilisés dans l'API Search Ads 360 Reporting sont hiérarchiques et reflètent l'organisation des entités dans Search Ads 360. Presque toutes les ressources sont des sous-ressources de la ressource Customer, ce qui reflète le fait que presque tous les appels d'API doivent cibler un compte Search Ads 360 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 de l'API Search Ads 360 Reporting (clients, campagnes, etc.) sont désignées par leur nom de ressource dans l'API. Toutefois, il est important de noter que les noms de ressources eux-mêmes peuvent avoir des ID de ressource numériques uniques qui identifient chaque objet de la hiérarchie. Dans ce cas, il peut être utile d'analyser le nom de la ressource pour extraire ces ID de ressource et en assembler un nouveau.
Par exemple, examinez le nom de la ressource AdGroupAd dans le tableau précédent:
customers/1234567890/adGroupAds/54321098765~2109876543210
Vous pouvez le décomposer en ID de ressource individuels (séparés par des ID de collection) comme suit:
| Composants du nom de la ressource | |||||||
|---|---|---|---|---|---|---|---|
| ID de ressource |
|
||||||
| ID de collection |
|
||||||
L'analyse des ID individuels vous permet d'obtenir de nouveaux noms de ressources pour faire référence au client (customers/1234567890) ou au groupe d'annonces (customers/1234567890/adGroupAds/54321098765) de l'annonce du groupe d'annonces.