Nomi delle risorse

Gerarchia dei nomi

I nomi delle risorse utilizzati nell'API Google Ads sono gerarchici e rispecchiano l'organizzazione delle entità in Google Ads. 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 Google Ads 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

Punto chiave: l'API Google Ads utilizza nomi di risorse relativi (e non nomi di risorse completi come alcune altre API di Google).

ID risorsa

Le entità Google Ads (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 cliente: "1234567890" ID gruppo di annunci: "54321098765" ID annuncio gruppo di annunci: "2109876543210"
ID raccolta	"customers" "adGroupAds"

L'analisi dei singoli ID 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.

Punto chiave: i nomi delle risorse nei campi della richiesta e della risposta JSON vengono indicati tramite il campo resourceName, non il campo name come in alcune altre API Google Cloud. Molte entità Google Ads hanno già attributi name (campaign.Name, adGroup.Name e così via), pertanto resourceName viene utilizzato per evitare conflitti con i nomi degli oggetti esistenti.

Identificatori di oggetti condivisi

La maggior parte degli oggetti nell'API è associata a un singolo cliente Google Ads specifico. Tuttavia, alcuni tipi di oggetti possono essere condivisi tra più account. In pratica, si tratta di elementi come gli elenchi di parole chiave escluse o le azioni di conversione cross-account che vengono solitamente creati dagli amministratori e poi condivisi con molti account cliente.

I nomi delle risorse di oggetti come questi variano a seconda dell'account a cui invii una chiamata API.

Esempio: azioni di conversione su più account

Supponiamo di avere l'account amministratore 987-654-3210 che condivide un'azione di conversione tra account con uno dei suoi account cliente 123-456-7890:

Se effettui una chiamata API all'account amministratore per, ad esempio, aggiornare la finestra temporale dell'azione di conversione, farai riferimento all'oggetto condiviso utilizzando il nome della risorsa: customers/9876543210/conversionActions/257733534.

Se effettui una chiamata API all'account cliente per attivare l'utilizzo dell'azione di conversione condivisa, fai riferimento a quest'ultima utilizzando il nome della risorsa: customers/1234567890/conversionActions/257733534.

Si tratta della stessa azione di conversione di base, ma il nome della risorsa è relativo all'account utilizzato per accedervi.