يُعرف المعرّف الفريد لكيان في 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)
تتضمّن كل خدمة أيضًا طريقة parse_*_path
مصاحبة تُحلّل اسم
resource_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"]
أسماء الموارد المركبة
تُنشئ أدوات مساعدة المسارات في الخدمات أقسامًا مركبة من اسم المورد. يتم قبول الأجزاء المختلفة من المعرّف المركب كمَعلمات فردية في الطريقة:
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
)