Die eindeutige Kennung für eine Entität in der Google Ads API wird als Ressourcennamen bezeichnet und als String mit einem vorhersehbaren Format dargestellt. Wenn Sie die Bestandteile eines Ressourcennamens kennen, können Sie Ressourcennamen mithilfe von Hilfsmethoden generieren, die in vielen Dienstobjekten vorhanden sind.
Methoden für Dienstpfade
Alle Dienste, die zum Lesen oder Ändern bestimmter Objekttypen in der API entwickelt wurden, haben Hilfsmethoden zum Erstellen von Ressourcennamen. Sie können beispielsweise einen Ressourcennamen für ein Campaign-Objekt erstellen:
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)
Jeder Dienst hat auch eine zugehörige parse_*_path-Methode, die einen Ressourcennamen in ein Dictionary seiner einzelnen Segmente zerlegt. Wenn der String nicht dem erwarteten Format entspricht, wird ein leeres Dictionary zurückgegeben.
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"]
Zusammengesetzte Ressourcennamen
Pfad-Hilfsmethoden für Dienste erstellen zusammengesetzte Segmente eines Ressourcennamens. Die verschiedenen Segmente der zusammengesetzten ID werden in der Methode als einzelne Parameter akzeptiert:
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
)