Nomi delle risorse

Gerarchia dei nomi

I nomi delle risorse utilizzati nell'API Search Ads 360 Reporting sono gerarchici e rispecchiano l'organizzazione delle entità all'interno di Search Ads 360. Quasi tutte le risorse sono risorse secondarie della Customer risorsa, il che riflette il fatto che quasi ogni chiamata API deve essere indirizzata a un account Search Ads 360 specifico. Ad esempio, campagne, gruppi di annunci, annunci e parole chiave sono tutte risorse secondarie di una risorsa cliente principale.

Risorsa Nome risorsa
Cliente customers/1234567890
Campagna customers/1234567890/campaigns/8765432109
AdGroup customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

ID risorsa

Le entità dell'API Search Ads 360 Reporting (clienti, campagne e così via) sono indicate con i relativi nomi delle risorse in tutta l'API. Tuttavia, è importante notare che i nomi delle risorse stessi potrebbero avere ID risorsanumerici univoci che identificano ogni oggetto nella gerarchia. In questi casi, potrebbe essere utile analizzare il nome della risorsa per estrarre questi ID risorsa e assemblarne uno nuovo.

Ad esempio, esamina il nome della risorsa AdGroupAd della tabella precedente:

customers/1234567890/adGroupAds/54321098765~2109876543210

Può essere suddiviso nei singoli ID risorsa (separati dagli ID raccolta) come segue:

Componenti del nome della risorsa
ID risorsa
ID cliente:
"1234567890"
ID gruppo di annunci:
"54321098765"
ID annuncio del gruppo di annunci:
"2109876543210"
ID raccolta
"customers"
"adGroupAds"

L'analisi dei singoli ID consente di derivare nuovi nomi di risorse per fare riferimento al cliente dell'annuncio del gruppo di annunci (customers/1234567890) o al relativo gruppo di annunci (customers/1234567890/adGroupAds/54321098765).