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

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

نظرة عامة

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

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

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

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

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

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

حساب عرض الإعلانات

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

• الغرض: هذا هو المكان الذي يتم فيه إنشاء الحملات والمجموعات الإعلانية والإعلانات وعرضها.

حساب العميل

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

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

العميل

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

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

حساب اختباري

حسابات الاختبار هي حسابات خاصة يتم إنشاؤها ضمن حساب إداري خصيصًا لاختبار عمليات الدمج مع واجهات برمجة التطبيقات.

• الغرض: تتيح لك هذه المفاتيح اختبار طلبات البيانات من واجهة برمجة التطبيقات بدون عرض إعلانات مباشرة أو تكبُّد تكاليف. ولا تعرض إعلانات مباشرة.

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

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

• الحساب الإداري (أ) (المستوى الأعلى)
  • حساب العميل "ب" (حساب عرض الإعلانات)
  • حساب العميل C (حساب إداري آخر)
    • حساب العميل D (حساب عرض الإعلانات)

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

• الحساب (أ) هو حساب إداري.
• الحسابات B وC وD هي حسابات عملاء بالنسبة إلى حسابات الأهل.
• الحسابان B وD هما حسابا عرض الإعلانات.
• الحساب C هو حساب عميل (للحساب A) وحساب إداري (للحساب D).