أنواع الحسابات في Google Ads API

يوضّح هذا المستند المصطلحات المختلفة المستخدَمة لوصف الحسابات في Google Ads API وكيفية ارتباطها ببعضها.

نظرة عامة

يستخدم Google Ads API عدة مصطلحات لوصف الحسابات، ما قد يؤدي أحيانًا إلى حدوث لبس. من المهم فهم هذه الفروقات لإدارة الحسابات وتفسير ردّ من واجهة برمجة التطبيقات.

أنواع الحسابات

توضّح التعريفات التالية أنواع الحسابات المختلفة التي ستصادفها عند استخدام Google Ads API.

الحساب الإداري

الحساب الإداري هو حساب أساسي يُستخدَم لإدارة حسابات متعدّدة على "إعلانات Google".

• الاسم السابق: كان يُعرف سابقًا باسم "مركز عملائي". وقد يظل هذا المصطلح يظهر في المستندات أو المناقشات القديمة.
• الغرض: استخدِم حسابًا إداريًا عندما تريد الربط بحسابات متعدّدة وإدارتها من خلال تسلسل هرمي واحد.
• تمثيله في واجهة برمجة التطبيقات: يتم تحديده من خلال مورد Customer حيث تكون قيمة customer.manager هي true.

حساب المعلِن (حساب عرض الإعلانات)

حساب المعلِن (أو حساب عرض الإعلانات) هو حساب فردي على "إعلانات Google" يعرض حملات إعلانية.

• الغرض: يتم فيه إنشاء الحملات والمجموعات الإعلانية ومجموعات مواد العرض والإعلانات وعرضها.
• تمثيله في واجهة برمجة التطبيقات: يتم تحديده من خلال مورد Customer حيث تكون قيمة customer.manager هي false.

حساب العميل

حساب العميل هو أي حساب (إما حساب معلِن أو حساب إداري آخر) يتم ربطه بحساب إداري أعلى منه في التسلسل الهرمي وإدارته من خلاله.

• السياق: يشير مصطلح "العميل" إلى العلاقة في التسلسل الهرمي (الذي يديره حساب إداري)، وليس بالضرورة إلى "عميل" بالمعنى التجاري.
• تمثيله في واجهة برمجة التطبيقات: استخدِم طلب البحث CustomerClient لفحص الحسابات في التسلسل الهرمي لحساب إداري، واستخدِم CustomerClientLink لإدارة الروابط بين الحسابات الإدارية وحسابات العملاء.

العميل

في سياق واجهة برمجة التطبيقات، العميل هو المورد الذي يمثّل أيّ حساب على "إعلانات Google"، سواء كان حسابًا إداريًا أو حساب معلِن.

• التمثيل: يتم تمثيل جميع الحسابات من خلال مورد Customer، يتم تحديده من خلال customer_id.
• الدور: تعتمد طبيعة الحساب (إداري أو عرض الإعلانات) على المورد المحدّد.

حساب اختباري

الحسابات الاختبارية هي حسابات معلِنين خاصة منظَّمة ضمن حساب إداري اختباري مخصّص لاختبار عمليات دمج واجهة برمجة التطبيقات. يتم ضبط الحقل customer.test_account على true لكلّ من الحساب الإداري الاختباري وحسابات المعلِنين الاختبارية ضمنه. لا يمكن إنشاء حسابات اختبارية ضمن حساب مدير المنتجات النهائي.

• الغرض: تتيح لك الحسابات الاختبارية اختبار طلبات بيانات من واجهة برمجة التطبيقات بدون عرض إعلانات نهائية أو تكبّد تكاليف. ولا تعرض هذه الحسابات إعلانات نهائية.
• تمثيله في واجهة برمجة التطبيقات: يتم تحديده من خلال مورد Customer حيث تكون قيمة customer.test_account هي true (مع استخدام customer.manager للتمييز بين الحساب الإداري الاختباري وحساب المعلِن الاختباري).

مثال على التسلسل الهرمي

يبدو التسلسل الهرمي النموذجي على النحو التالي:

• الحساب الإداري (أ) (المستوى الأعلى)
  • حساب العميل (ب) (حساب معلِن)
  • حساب العميل (ج) (حساب إداري آخر)
    • حساب العميل (د) (حساب معلِن)

في هذا المثال:

• الحساب (أ) هو حساب إداري.
• الحسابات (ب) و(ج) و(د) هي حسابات عملاء بالنسبة إلى حساباتها الرئيسية.
• الحسابان (ب) و(د) هما حسابا معلِن (عرض الإعلانات).
• الحساب (ج) هو حساب عميل (بالنسبة إلى الحساب أ) وحساب إداري (بالنسبة إلى الحساب د).