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 risorsa Customer, il che riflette il fatto che quasi tutte le chiamate API devono avere come target uno specifico account Search Ads 360. Le campagne, i gruppi di annunci, gli annunci e le parole chiave
sono tutte risorse secondarie di una risorsa cliente radice.
| Risorsa | Nome risorsa |
|---|---|
| Cliente | customers/1234567890
|
| Priorità | 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) vengono indicate con i nomi delle risorse in tutta l'API. Tuttavia, è importante notare che i nomi delle risorse stessi possono avere ID risorsa numerici univoci che identificano ciascun oggetto nella gerarchia. In questi casi, può essere utile analizzare il nome della risorsa per estrarre questi ID risorsa e crearne uno nuovo.
Ad esempio, esamina il nome della risorsa AdGroupAd della tabella precedente:
customers/1234567890/adGroupAds/54321098765~2109876543210
Può essere suddiviso in singoli ID risorsa (separati da ID raccolta) come segue:
| Componenti dei nomi delle risorse | |||||||
|---|---|---|---|---|---|---|---|
| ID risorsa |
|
||||||
| ID raccolta |
|
||||||
L'analisi dei singoli ID ti consente di ricavare nuovi nomi delle risorse per fare riferimento
al cliente dell'annuncio del gruppo di annunci (customers/1234567890) o al relativo gruppo di annunci
(customers/1234567890/adGroupAds/54321098765).