Nomi delle risorse

Gerarchia dei nomi

I nomi delle risorse utilizzati nell'API Google Ads sono gerarchici e rispecchiano l'organizzazione delle entità all'interno di Google Ads. 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 un account Google Ads specifico. 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

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

ID risorsa

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

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).

Punto chiave: i nomi delle risorse nei corpi di richiesta e risposta JSON sono indicati dal campo resourceName, non dal campo name come in alcune altre API Google Cloud. Molte entità Google Ads dispongono di attributi nome (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 sono associati a un singolo cliente Google Ads specifico. Tuttavia, alcuni tipi di oggetti possono essere condivisi tra più account. In pratica, si tratta di elenchi di parole chiave escluse o azioni di conversione su più account, che in genere vengono creati dagli amministratori e poi condivisi con molti account cliente.

I nomi delle risorse di oggetti come questi saranno diversi, a seconda dell'account a cui stai inviando 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 degli account cliente del suo cliente 123-456-7890:

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

Nel caso di una chiamata API all'account cliente per l'attivazione dell'azione di conversione condivisa, la chiamata all'account cliente verrà indicata utilizzando il nome della risorsa: customers/1234567890/conversionActions/257733534.

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