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

يُطلق على المعرّف الفريد لكيان في 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)