Die eindeutige Kennung für eine Entität in der Google Ads API wird als Ressourcenname bezeichnet und als String mit einem vorhersagbaren Format dargestellt. Wenn Sie die einzelnen Komponenten eines Ressourcennamens kennen, können Sie Ressourcennamen mit 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 resource_names. 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)
Für jeden Dienst gibt es auch eine zugehörige parse_*_path-Methode, mit der ein resource_name in seine einzelnen Segmente zerlegt wird, z. B.:
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-Helfer für Dienste erstellen zusammengesetzte Segmente eines Ressourcennamens. Die verschiedenen Segmente der zusammengesetzten ID werden als einzelne Parameter in der Methode akzeptiert:
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
)