Die eindeutige Kennung für eine Entität in der Google Ads API wird als Ressource bezeichnet. Name und wird als Zeichenfolge mit vorhersehbarem Format dargestellt. Wenn Sie wissen, die einzelnen Komponenten eines Ressourcennamens enthalten, können Sie mithilfe von Hilfsmethoden, die bei vielen Service-Objekten vorhanden sind.
Dienstpfadmethoden
Alle Dienste, die für das Lesen oder Ändern bestimmter Arten von
-Objekte in der API verfügen über Hilfsmethoden, die die Konstruktion erleichtern.
Resource_names an. 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 ein
zugehörige Methode parse_*_path, die einen "resource_name" in einen eigenen
einzelne Segmente, 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
Ab Version 9.0.0 der Clientbibliothek, Pfadhilfen für Dienste zusammengesetzte Segmente eines Ressourcennamens erstellen. Die verschiedenen Segmente des zusammengesetzte 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
)
Versionen vor 9.0.0
Vor Version 9.0.0 konstruieren die Path Helpers für Dienste das Feld zusammengesetztes Segment eines Ressourcennamens. Diese Segmente müssen vom Anrufer. 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
)