يوضّح هذا المستند المصطلحات المختلفة المستخدَمة لوصف الحسابات في Google Ads API وكيفية ارتباطها ببعضها.
نظرة عامة
تستخدم Google Ads API عدة مصطلحات لوصف الحسابات، ما قد يؤدي أحيانًا إلى حدوث لبس. من المهم فهم هذه الفروقات لإدارة الحسابات وتفسير ردود واجهة برمجة التطبيقات.
أنواع الحسابات
توضّح التعريفات التالية أنواع الحسابات المختلفة التي ستصادفها عند استخدام Google Ads API.
الحساب الإداري
الحساب الإداري هو حساب أساسي يُستخدَم لإدارة حسابات متعدّدة على "إعلانات Google".
- الاسم السابق: كان يُعرف سابقًا باسم "مركز عملائي". وقد يظل هذا المصطلح يظهر في المستندات أو المناقشات القديمة.
- الغرض: تحتاج إلى حساب إداري لتتمكّن من الربط بحسابات متعدّدة وإدارتها باستخدام واجهة برمجة التطبيقات.
حساب عرض الإعلانات
حساب عرض الإعلانات (أو حساب المعلِن) هو حساب فردي على "إعلانات Google" يعرض حملات إعلانية.
- الغرض: يتم فيه إنشاء الحملات والمجموعات الإعلانية والإعلانات وعرضها.
حساب العميل
حساب العميل هو أي حساب (إما حساب عرض إعلانات أو حساب إداري آخر) يتم ربطه بحساب إداري أعلى منه في العرض الهرمي وإدارته من خلاله.
- السياق: يشير مصطلح "العميل" إلى العلاقة في العرض الهرمي (الذي يديره مدير)، وليس بالضرورة إلى "عميل" بالمعنى التجاري.
العميل
في سياق واجهة برمجة التطبيقات، العميل هو المورد الذي يمثّل أيّ حساب على "إعلانات Google"، سواء كان حسابًا إداريًا أو حساب عرض إعلانات.
- التمثيل: يتم تمثيل جميع الحسابات بمورد
Customer، يتم تحديده من خلالcustomer_id. - الدور: تعتمد طبيعة الحساب (إداري أو عرض إعلانات) على المورد المحدّد.
حساب اختباري
الحسابات الاختبارية هي حسابات خاصة يتم إنشاؤها ضمن حساب إداري خصيصًا لاختبار عمليات دمج واجهة برمجة التطبيقات.
- الغرض: تتيح لك الحسابات الاختبارية اختبار طلبات واجهة برمجة التطبيقات بدون عرض إعلانات معروضة أو تكبّد تكاليف. ولا تعرض هذه الحسابات إعلانات معروضة.
مثال على العرض الهرمي
يبدو العرض الهرمي النموذجي على النحو التالي:
- الحساب الإداري أ (المستوى الأعلى)
- حساب العميل ب (حساب عرض إعلانات)
- حساب العميل ج (حساب إداري آخر)
- حساب العميل د (حساب عرض إعلانات)
في هذا المثال:
- الحساب "أ" هو حساب إداري.
- الحسابات "ب" و"ج" و"د" هي حسابات عملاء بالنسبة إلى حساباتها الرئيسية.
- الحسابان "ب" و"د" هما حسابا عرض إعلانات.
- الحساب "ج" هو حساب عميل (بالنسبة إلى "أ") وحساب إداري (بالنسبة إلى "د").