التدرّج الهرمي للأسماء
إنّ أسماء الموارد المستخدَمة في Google Ads API هي أسماء هرمية، وتعكس تنظيم الكيانات ضمن "إعلانات Google". معظم الموارد هي موارد فرعية من المورد Customer، ما يشير إلى أنّه يجب أن يستهدف كل طلب بيانات من واجهة برمجة التطبيقات حسابًا معيّنًا على "إعلانات Google". على سبيل المثال، الحملات والمجموعات الإعلانية والإعلانات والكلمات الرئيسية هي جميعها موارد فرعية لمورد العميل الأساسي.
| المرجع | اسم المورد |
|---|---|
| العميل | customers/1234567890
|
| الحملة | customers/1234567890/campaigns/8765432109
|
| المجموعة الإعلانية | 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.
وهو إجراء الإحالة الناجحة الأساسي نفسه، ولكن اسم المورد الخاص به يكون مرتبطًا بالحساب المستخدَم للوصول إليه.