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 chaque appel d'API doit 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 ressource AdGroupAd de la table précédente:
customers/1234567890/adGroupAds/54321098765~2109876543210
Il peut être décomposé en ID de ressource individuels (séparés par un ID de collection) comme suit:
| Composants des noms de ressources | |||||||
|---|---|---|---|---|---|---|---|
| ID de ressource |
|
||||||
| ID de collection |
|
||||||
L'analyse des ID individuels vous permet d'obtenir 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).