التدرّج الهرمي للأسماء
تكون أسماء الموارد المستخدمة في 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
هذا هو إجراء الإحالة الناجحة الأساسي نفسه، ولكن اسم مورده نسبي إلى الحساب المستخدم للوصول إليها.