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