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 ogni chiamata API deve avere come target un account Search Ads 360 specifico. Ad esempio, campagne, gruppi di annunci, annunci e parole chiave
sono tutte le risorse secondarie di una risorsa cliente principale.
| Risorsa | Nome risorsa |
|---|---|
| Cliente | customers/1234567890
|
| Campagna | customers/1234567890/campaigns/8765432109
|
| Gruppo di annunci | 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 tramite i relativi nomi di risorsa nell'API. Tuttavia, è importante notare che i nomi delle risorse possono avere ID risorse numerici univoci che identificano ogni oggetto nella gerarchia. In questi casi, può essere utile analizzare il nome della risorsa per estrarre questi ID risorsa e assemblarne uno nuovo.
Ad esempio, esamina il nome della risorsa AdGroupAd nella tabella precedente:
customers/1234567890/adGroupAds/54321098765~2109876543210
Questo può essere suddiviso nei singoli ID risorsa (separati da ID raccolta) come segue:
| Componenti del nome della risorsa | |||||||
|---|---|---|---|---|---|---|---|
| ID risorsa |
|
||||||
| ID raccolta |
|
||||||
L'analisi dei singoli ID ti consente di ricavare nuovi nomi di risorse per fare riferimento al cliente (customers/1234567890) o al gruppo di annunci (customers/1234567890/adGroupAds/54321098765) dell'annuncio del gruppo di annunci.