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

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

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

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

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

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

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

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

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

معرّفات العناصر المشتركة

ترتبط معظم العناصر في واجهة برمجة التطبيقات بعميل واحد محدّد في "إعلانات Google". مع ذلك، هناك بعض أنواع العناصر التي يمكن مشاركتها بين حسابات متعددة. من الناحية العملية، هناك أشياء مثل قوائم الكلمات الرئيسية السلبية أو إجراءات الإحالات الناجحة في جميع الحسابات التي ينشئها عادةً المديرون ثم تتم مشاركتها مع العديد من حسابات العملاء.

ستختلف أسماء الموارد لكائنات مثل هذه، بناءً على الحساب الذي ترسل إليه طلب بيانات من واجهة برمجة التطبيقات.

مثال: إجراءات الإحالات الناجحة في جميع الحسابات

لنفترض أنّ لدينا حساب إداري 987-654-3210 يشارك إجراء إحالة ناجحة في جميع الحسابات مع أحد حسابات العملاء لديه 123-456-7890:

مخطّط بياني يوضّح علاقة أسماء الموارد بالتدرجات الهرمية للحساب

إنّ إجراء طلب بيانات من واجهة برمجة التطبيقات إلى الحساب الإداري من أجل، على سبيل المثال، لتعديل فترة معاينة الإعلان الخاص بإجراء الإحالة الناجحة، سيشير إلى العنصر المشترَك باستخدام اسم المورد: customers/9876543210/conversionActions/257733534.

سيؤدي إجراء طلب بيانات من واجهة برمجة التطبيقات إلى حساب العميل للموافقة على استخدام إجراء الإحالة الناجحة المشترك إلى الإشارة إليه باستخدام اسم المورد: customers/1234567890/conversionActions/257733534.

وهذا هو إجراء الإحالة الناجحة الأساسي نفسه، ولكن اسم مورده مرتبط بالحساب المستخدَم للوصول إليه.