Gerarchia dei nomi
I nomi delle risorse utilizzati nell'API Google Ads sono gerarchici e rispecchiano
organizzazione di persone giuridiche in Google Ads. Quasi tutte le risorse sono risorse secondarie
di Customer
risorsa, il che riflette il fatto che quasi tutte le chiamate API devono avere come target
un account Google Ads specifico. Ad esempio, campagne, gruppi di annunci, annunci e parole chiave
sono tutte risorse secondarie di una risorsa
del cliente radice.
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à Google Ads (clienti, campagne e così via) vengono indicate dalla risorsa personalizzati in tutta l'API. Tuttavia, è importante notare che le risorse i nomi stessi possono avere risorse numeriche uniche ID che identificano ogni oggetto della gerarchia. In questi casi, può essere utile analizzare nome risorsa per estrarre questi ID 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 di risorse a cui fare riferimento
il cliente dell'annuncio del gruppo di annunci (customers/1234567890
) o il relativo gruppo di annunci
(customers/1234567890/adGroupAds/54321098765
).
Identificatori di oggetti condivisi
La maggior parte degli oggetti nell'API è associata a un singolo account Google Ads specifico al cliente. Tuttavia, esistono alcuni tipi di oggetti che possono essere condivisi più account. In pratica, questi sono parametri come parola chiave esclusa elenchi o su più account azioni di conversione in genere create dagli amministratori e condivise con molti account cliente.
I nomi delle risorse di oggetti come questi saranno diversi, a seconda account a cui stai inviando una chiamata API.
Esempio: azioni di conversione su più account
Supponiamo di avere un account amministratore 987-654-3210
che condivide più account
azione di conversione con uno degli account cliente del cliente 123-456-7890
:
Effettuare una chiamata API all'account amministratore, ad esempio per aggiornare la conversione
finestra temporale dell'azione fa riferimento all'oggetto condiviso utilizzando il nome risorsa:
customers/9876543210/conversionActions/257733534
.
Effettuare una chiamata API all'account cliente per attivare l'utilizzo della condivisione
l'azione di conversione può farvi riferimento utilizzando il nome risorsa:
customers/1234567890/conversionActions/257733534
.
Si tratta della stessa azione di conversione sottostante, ma il nome della risorsa è relativo all'account utilizzato per accedervi.