L'identificatore univoco di un'entità nell'API Google Ads è chiamato nome della risorsa ed è rappresentato come una stringa con un formato prevedibile. Se conosci i componenti costitutivi di un nome della risorsa, puoi generare i nomi delle risorse utilizzando i metodi helper presenti in molti oggetti di servizio.
Metodi del percorso del servizio
Tutti i servizi progettati per gestire la lettura o la modifica di tipi specifici di oggetti nell'API hanno metodi helper per creare nomi delle risorse. Ad esempio, puoi creare un nome della 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)
Ogni servizio ha anche un metodo parse_*_path di accompagnamento che decostruisce un nome della risorsa in un dizionario dei suoi singoli segmenti (o restituisce un dizionario vuoto se la stringa non corrisponde al formato previsto):
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 composite
Gli helper del percorso sui servizi creano segmenti compositi di un nome della risorsa. I diversi segmenti dell'ID composito vengono accettati come parametri individuali nel metodo:
from google.ads.googleads.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 these 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
)