Gerarchia dei nomi
I nomi delle risorse utilizzati nell'API Google Ads sono gerarchici e riflettono l'organizzazione delle entità all'interno di Google Ads. 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 Google Ads 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à Google Ads (clienti, campagne e così via) vengono indicate con i relativi nomi delle risorse nell'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
Questo può essere suddiviso nei singoli ID risorsa (separati dagli ID raccolta) come segue:
| Componenti del nome della risorsa | |||||||
|---|---|---|---|---|---|---|---|
| ID risorsa |
|
||||||
| ID raccolta |
|
||||||
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).
Identificatori di oggetti condivisi
La maggior parte degli oggetti nell'API è associata a un singolo cliente Google Ads specifico. Tuttavia, esistono alcuni tipi di oggetti che possono essere condivisi tra più account. In pratica, si tratta di elementi come gli elenchi di parole chiave negative o le azioni di conversione su più account che di solito vengono creati dagli amministratori e poi condivisi con molti account cliente.
I nomi delle risorse di questi oggetti 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 su più account con uno dei suoi account di intermediazione 123-456-7890:
Se effettui una chiamata API all'account amministratore per, ad esempio, aggiornare la finestra temporale dell'azione di conversione, l'oggetto condiviso verrà indicato 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, questa verrà indicata utilizzando il nome della risorsa: customers/1234567890/conversionActions/257733534.
Si tratta della stessa azione di conversione sottostante, ma il relativo nome della risorsa è relativo all'account utilizzato per accedervi.