أسماء الموارد

يُطلق على المعرّف الفريد لأحد العناصر في Google Ads API اسم مورد، ويتم تمثيله كسلسلة بتنسيق يمكن توقّعه. إذا كنت تعرف المكوّنات الأساسية لاسم المورد، يمكنك استخدام PathLookupUtil لإنشاء اسم المورد النهائي.

PathLookupUtil

تنشئ الأداة المساعدة PathLookupUtil اسم المورد الخاص بكيان معيّن عند تقديم جميع أرقام التعريف ذات الصلة بهذا الكيان. على سبيل المثال، يستخدم اسم مورد الحملة التنسيق customers/{customer_id}/campaigns/{campaign_id}، لذا إذا كنت تعرف رقم تعريف العميل ورقم تعريف الحملة، يمكنك استخدام client.path لإنشاء اسم المورد الكامل:

require 'google/ads/google_ads'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
customer_id = '1234567890'
campaign_id = '9876543210'

# Generates: "customers/1234567890/campaigns/9876543210"
campaign_resource_name = client.path.campaign(customer_id, campaign_id)

الكيانات المتوافقة

يمكنك أيضًا استخدام أسماء كيانات أخرى في client.path، والتي تقبل معرّفات مختلفة استنادًا إلى التسلسل الهرمي لاسم المورد:

  • الحملة: client.path.campaign(customer_id, campaign_id)
  • المجموعة الإعلانية: client.path.ad_group(customer_id, ad_group_id)
  • إعلان المجموعة الإعلانية: client.path.ad_group_ad(customer_id, ad_group_id, ad_id)