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

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

تكون أسماء الموارد المستخدَمة في 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).