L'identificatore univoco di un'entità nell'API Google Ads è chiamato nome risorsa ed è rappresentato da una stringa con un formato prevedibile. Se conosci i componenti che costituiscono il nome di una risorsa, puoi generare nomi delle risorse utilizzando i metodi helper presenti in molti oggetti Service.
Metodi del percorso del servizio
Tutti i servizi progettati per gestire la lettura o la modifica di tipi specifici di oggetti nell'API dispongono di metodi helper che semplificano la creazione diresource_names. Ad esempio, creando 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 un metodo parse_*_path che scompone un resource_name nei propri segmenti singoli, 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 di risorse composite
A partire dalla versione 9.0.0 della libreria client, gli assistenti per i percorsi sui servizi creano segmenti composti di un nome risorsa. I diversi segmenti dell'ID composito vengono accettati come parametri individuali 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 percorso sui servizi non creano il segmento composito di un nome risorsa. Questi segmenti devono essere forniti dal chiamante. La libreria client ha una piccola utilità che ti consente di 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
)