المعرّف الفريد لكيان في إعلانات Google API يُطلق عليه اسم المورد، ويتم تمثيله كسلسلة بتنسيق يمكن التنبؤ به. إذا كنت تعرف المكوّنات المكوّنة لاسم المورد، يمكنك إنشاء أسماء موارد باستخدام طرق مساعدة متاحة في العديد من كائنات الخدمة.
طرق مسار الخدمة
تحتوي جميع الخدمات المصممة للتعامل مع قراءة أنواع معينة من الكائنات أو تغييرها في واجهة برمجة التطبيقات على طرق مساعدة لتسهيل إنشاء
اسم_الموارد. على سبيل المثال، إنشاء اسم مورد لكائن 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 مصاحبة تفصّل اسم المورد ضمن أقسامه الفردية، على سبيل المثال:
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
)