أنواع الحسابات في 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 لتمييز حساب مدير اختباري عن حساب معلِن اختباري).

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

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

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

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

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