Die eindeutige Kennung für eine Entität in der Google Ads API wird als Ressourcenname bezeichnet und als String mit einem vorhersehbaren Format dargestellt. Wenn Sie die einzelnen Komponenten eines Ressourcennamens kennen, können Sie Ressourcennamen mithilfe von Hilfsmethoden generieren, die in vielen Dienstobjekten verfügbar sind.
Dienstpfadmethoden
Alle Dienste, die das Lesen oder Ändern bestimmter Objekttypen in der API verarbeiten sollen, haben Hilfsmethoden, die das Erstellen von "resource_names" erleichtern. So erstellen Sie beispielsweise einen Ressourcennamen für ein Campaign-Objekt:
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)
Ab Version 10.0.0 der Clientbibliothek hat jeder Dienst auch eine zugehörige parse_*_path-Methode, die einen "resource_name" in seine einzelnen Segmente dekonstruiert. Beispiel:
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
Ab Version 9.0.0 der Clientbibliothek erstellen Pfadhilfen für Dienste zusammengesetzte Segmente eines Ressourcennamens. Die verschiedenen Segmente der zusammengesetzten ID werden in der Methode als einzelne Parameter 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
)
Versionen vor 9.0.0
Vor Version 9.0.0 erstellen die Pfadhilfen für Dienste kein zusammengesetztes Segment eines Ressourcennamens. Diese Segmente müssen vom Aufrufer bereitgestellt werden. Die Clientbibliothek enthält ein kleines Dienstprogramm, das Ihnen dabei hilft:
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
)