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

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

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

المورد اسم المورد
العميل customers/1234567890
الحملة customers/1234567890/campaigns/8765432109
المجموعة الإعلانية 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) للإعلان في المجموعة الإعلانية.