التسلسل الهرمي للأسماء
تكون أسماء الموارد المستخدَمة في 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
يمكن تقسيم هذا الاسم إلى معرّفات الموارد الفردية (مفصولة ب معرّفات المجموعة) على النحو التالي:
| مكوّنات اسم المورد | |||||||
|---|---|---|---|---|---|---|---|
| معرّفات الموارد |
|
||||||
| معرّفات المجموعة |
|
||||||
يتيح لك تحليل المعرّفات الفردية استخلاص أسماء موارد جديدة للإشارة إلى
عميل الإعلان في المجموعة الإعلانية (customers/1234567890) أو مجموعته الإعلانية
(customers/1234567890/adGroupAds/54321098765).
معرّفات الكائنات المشترَكة
يرتبط معظم الكائنات في واجهة برمجة التطبيقات بعميل واحد محدّد على "إعلانات Google". ومع ذلك، هناك بعض أنواع الكائنات التي يمكن مشاركتها بين حسابات متعدّدة. في الواقع، هذه الأنواع هي قوائم الكلمات الرئيسية السلبية أو إجراءات الإحالات الناجحة المُدارة في عدّة حسابات التي ينشئها عادةً المديرون ثم يشاركونها مع العديد من حسابات العملاء.
ستختلف أسماء موارد هذه الكائنات، استنادًا إلى الحساب الذي ترسل إليه طلب بيانات من واجهة برمجة التطبيقات.
مثال: إجراءات الإحالات الناجحة المُدارة في عدّة حسابات
لنفترض أنّ لدينا حسابًا إداريًا 987-654-3210 يشارك إجراء إحالة ناجحة مُدارة في عدّة حسابات مع أحد حسابات العملاء 123-456-7890:
عند إرسال طلب بيانات من واجهة برمجة التطبيقات إلى الحساب الإداري، مثلاً لتعديل فترة معاينة الإعلان لإجراء الإحالة الناجحة، سيشير الطلب إلى الكائن المشترَك باستخدام اسم المورد: customers/9876543210/conversionActions/257733534.
عند إرسال طلب بيانات من واجهة برمجة التطبيقات إلى حساب العميل للموافقة على استخدام إجراء الإحالة الناجحة المشترَك، سيشير الطلب إلى هذا الإجراء باستخدام اسم المورد: customers/1234567890/conversionActions/257733534.
هذا هو إجراء الإحالة الناجحة الأساسي نفسه، ولكن اسم المورد نسبي إلى الحساب المستخدَم للوصول إليه.