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

التدرّج الهرمي للأسماء

إنّ أسماء الموارد المستخدَمة في Search Ads 360 Reporting API هي أسماء هرمية، ما يعكس تنظيم الكيانات في "إعلانات شبكة البحث 360". تكون جميع الموارد تقريبًا عبارة عن موارد فرعية من مورد Customer، ما يعكس حقيقة أنّ كل طلب من واجهة برمجة التطبيقات تقريبًا يجب أن يستهدف حسابًا محددًا على "إعلانات شبكة البحث 360". على سبيل المثال، الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية عبارة عن موارد فرعية لمورد أساسي للعملاء.

المورد اسم المورد
العميل customers/1234567890
الحملة customers/1234567890/campaigns/8765432109
AdGroup customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

أرقام تعريف الموارد

تتم الإشارة إلى كيانات Search Ads 360 Reporting API (العملاء والحملات وغير ذلك) من خلال أسماء مواردها من خلال واجهة برمجة التطبيقات. وتجدر الإشارة إلى أنّ أسماء الموارد نفسها قد تحتوي على معرّفات موارد رقمية فريدة تحدّد كلّ عنصر في التسلسل الهرمي. في هذه الحالات، قد يكون من المفيد تحليل اسم المورد لاستخراج معرّفات الموارد هذه وتجميع معرّف جديد.

على سبيل المثال، افحص اسم المورد AdGroupAd من الجدول السابق:

customers/1234567890/adGroupAds/54321098765~2109876543210

يمكن تقسيم ذلك إلى معرّفات الموارد الفردية (مفصولة بمعرّفات المجموعات) على النحو التالي:

مكونات اسم المورد
معرّفات الموارد
الرقم التعريفي للعميل:
"1234567890"
رقم تعريف المجموعة الإعلانية:
"54321098765"
رقم تعريف إعلان المجموعة الإعلانية:
"2109876543210"
أرقام تعريف المجموعات
"customers"
"adGroupAds"

يتيح لك تحليل أرقام التعريف الفردية الحصول على أسماء موارد جديدة للإشارة إلى عميل إعلان المجموعة الإعلانية (customers/1234567890) أو مجموعته الإعلانية (customers/1234567890/adGroupAds/54321098765).