L'identificatore univoco di un'entità nell'API Google Ads è chiamato risorsa ed è rappresentato come una stringa con un formato prevedibile. Se sai componenti di un nome risorsa, puoi generare nomi di risorse usando metodi helper presenti in molti oggetti di servizio.
Metodi del percorso di servizio
Tutti i Servizi progettati per gestire la lettura o la modifica di tipi specifici di
di oggetti nell'API dispongono di metodi helper per semplificare la creazione
nome_risorsa. Ad esempio, crea un nome risorsa per un oggetto Campaign:
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
customer_id = "7892134783"
campaign_id = "1234567890"
campaign_service = client.get_service("CampaignService")
resource_name = campaign_service.campaign_path(customer_id, campaign_id)
A partire dalla versione 10.0.0 della libreria client, ogni servizio include anche
associato al metodo parse_*_path che scompone un valore resource_name nel relativo
segmenti individuali, ad esempio:
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
resource_name = "customers/7892134783/campaigns/1234567890"
campaign_service = client.get_service('CampaignService')
segments = campaign_service.parse_campaign_path(resource_name)
customer_id = segments["customer_id"]
campaign_id = segments["campaign_id"]
Nomi delle risorse composita
A partire dalla versione 9.0.0 della libreria client, helper per il percorso sui servizi creare segmenti compositi di un nome risorsa. I diversi segmenti ID composito sono accettati come singoli parametri nel metodo:
from google.ads.google_ads.client import GoogleAdsClient
customer_id = "0987654321"
ad_group_id = "1234567890"
criterion_id = "74932"
client = GoogleAdsClient.load_from_storage()
ad_group_criterion_service = client.get_service("AdGroupCriterionService")
# An AdGroupCriterion resource name that uses the above IDs looks like this:
# "customers/0987654321/adGroupCriteria/1234567890~74932"
resource_name = ad_group_criterion_service.ad_group_criterion_path(
customer_id, ad_group_id, criterion_id
)
Versioni precedenti alla 9.0.0
Prima della versione 9.0.0, gli helper del percorso sui servizi non costruiscono segmento composito di un nome risorsa. Questi segmenti devono essere forniti chiamante. La libreria client dispone di una piccola utilità per eseguire questa operazione:
from google.ads.google_ads.client import GoogleAdsClient
from google.ads.google_ads.util import ResourceName
customer_id = "0987654321"
ad_group_id = "1234567890"
criterion_id = "74932"
client = GoogleAdsClient.load_from_storage()
ad_group_criterion_service = client.get_service("AdGroupCriterionService")
# An AdGroupCriterion resource name that uses the above IDs looks like this:
# "customers/0987654321/adGroupCriteria/1234567890~74932"
composite_id = ResourceName.format_composite(ad_group_id, criterion_id)
resource_name = ad_group_criterion_service.ad_group_criterion_path(
customer_id, composite_id
)