يُطلق على المعرّف الفريد للكيان في Google Ads API اسم "اسم المورد"، ويتم تمثيله كسلسلة بتنسيق يمكن توقُّعه. إذا كنت تعرف المكوّنات الأساسية لاسم المورد، يمكنك إنشاء أسماء موارد باستخدام الطرق المساعدة المتوفّرة في العديد من عناصر الخدمة.
طرق مسار الخدمة
تشتمل جميع الخدمات المُصمّمة لمعالجة أنواع معيّنة من العناصر في واجهة برمجة التطبيقات على طرق مساعِدة لتسهيل عملية إنشاء الموارد resource_names. على سبيل المثال، إنشاء اسم مورد لكائن 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)
بدءًا من الإصدار 10.0.0 من مكتبة العملاء، سيكون لكل خدمة أيضًا طريقة parse_*_path مرتبطة بكل خدمة تعمل على تفكيك source_name إلى أقسامها الفردية، على سبيل المثال:
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"]
أسماء الموارد المركّبة
بدءًا من الإصدار 9.0.0 من مكتبة العملاء، تنشئ مساعدات المسار في الخدمات شرائح مُركّبة من اسم مورد. يتم قبول المقاطع المختلفة للمعرف المركب كمعلمات فردية في الطريقة:
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
)
الإصدارات السابقة على 9.0.0
قبل الإصدار 9.0.0، لم تنشئ مساعدات المسار في الخدمات الجزء المركب لاسم مورد. يجب أن يتم تقديم هذه الشرائح من قبل المتصل. تحتوي مكتبة البرامج على أداة مساعدة صغيرة للمساعدة في هذا الأمر:
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
)