إعداد حساب العميل

في هذه الخطوة، عليك تحديد حساب على "إعلانات Google" لإجراء طلبات البيانات من واجهة برمجة التطبيقات إليه. يمكن أن يكون الحساب حسابًا للإنتاج (مباشرًا) أو حسابًا تجريبيًا. ولكل نهج مزاياه وعيوبه.

حسابات الإنتاج
حسابات الاختبار
الإيجابيات
  • تسهيل كتابة واختبار الرمز البرمجي الذي يعمل مع محتوى حساب معيّن
  • تسهيل كتابة الرموز واختبارها لمعالجة بيانات التقارير المباشرة
  • لا تعرض الحسابات الاختبارية إعلانات، وبالتالي لن تؤثر أخطاء البرمجة في حملاتك المباشرة.
  • تعمل هذه الطريقة مع الرموز المميزة للمطوّرين التي لديها مستوى الوصول إلى الاختبار.
العيوب
  • قد يؤدي خطأ برمجي في مرحلة التطوير إلى التأثير في عرض الحملات المباشرة، ما يؤدي إلى مشاكل مثل ضعف أداء الحملة أو العرض غير الصحيح أو الخسائر المالية.
  • يجب أن يكون رمز المطوِّر المميز على مستوى "إذن الوصول الأساسي" على الأقل لإجراء طلبات البيانات من واجهة برمجة التطبيقات.
  • يجب إعادة إنشاء الحملات داخل الحسابات التجريبية لاختبار الرمز الذي يعمل مع محتوى حساب معيّن.
  • بما أنّ الحسابات التجريبية لا تعرض إعلانات، لا تتوفّر الميزات المرتبطة بالعرض المباشر، مثل إحصاءات التقارير أو أخطاء انتهاك السياسة أو معالجة عمليات استيراد الإحالات الناجحة بلا إنترنت، ما يصعّب اختبار هذه الميزات.

ننصحك باستخدام حساب تجريبي أثناء تطوير تطبيقك عند الإمكان. للحصول على التعليمات، يُرجى الاطّلاع على إنشاء حسابات وحملات تجريبية.

يمكنك بدلاً من ذلك إعداد حساب إنتاج بميزانية حساب منخفضة، مثل دولار واحد في اليوم، وذلك بشكل صريح لاختبار الميزات التي لا يتيحها حساب الاختبار.

اختيار مجموعة الميزات

عند اختيار حساب لإجراء طلب بيانات من واجهة برمجة التطبيقات، يجب مراعاة قائمة الميزات التي تريد استخدامها مع واجهة برمجة التطبيقات. حتى إذا اخترت استخدام حساب إنتاج، ستتوفّر بعض الميزات الخاصة بالحساب، مثل:

  • لاستخدام ميزات الفوترة، يجب أن يكون لديك حساب يستخدم نظام الفواتير الشهرية.
  • قد يتم حظر بعض الميزات الجديدة في الحساب من خلال قوائم السماح.

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

تحديد رقم تعريف العميل المستخدَم في تسجيل الدخول ورقم تعريف العميل

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

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

بعد تحديد عميل "إعلانات Google" الذي سيتم إجراء طلبات البيانات من واجهة برمجة التطبيقات إليه، سجِّل التفاصيل التالية:

  • الرقم التعريفي للعميل المكوّن من 10 أرقام والخاص بحساب العميل الذي تخطّط لإجراء طلبات إلى واجهة برمجة التطبيقات فيه. ويُشار إلى هذا النوع من العملاء أحيانًا باسم "العميل النشط".

  • رقم تعريف العميل المكوّن من 10 أرقام والذي يتم استخدامه لتسجيل الدخول إلى حساب العميل الذي تم تسجيل الدخول إليه. إذا كنت مسجّلاً الدخول إلى حساب العميل الأساسي، سيكون رقم تعريف العميل المستخدَم في تسجيل الدخول هو نفسه رقم تعريف العميل. إذا سجّلت الدخول إلى حساب إداري تابع للعميل المشغّل، يكون الرقم التعريفي للعميل الذي سجّل الدخول هو الرقم التعريفي للعميل التابع للحساب الإداري.

منح الإذن بالوصول إلى حساب الخدمة

  1. أثناء تسجيل الدخول إلى حسابك على "إعلانات Google" بصفتك مشرفًا، انتقِل إلى المشرف > الوصول والأمان.

  2. انقر على الزر + ضمن علامة التبويب المستخدمون.

  3. اكتب عنوان البريد الإلكتروني لحساب الخدمة في مربّع الإدخال البريد الإلكتروني. اختَر مستوى الوصول المناسب إلى الحساب، ثم انقر على الزر إضافة حساب. يُرجى العِلم أنّ مستوى الوصول عبر البريد الإلكتروني غير متاح لحسابات الخدمة.

  4. يتم منح حساب الخدمة إذن الوصول.

بشكلٍ تلقائي، لا يمكنك منح حساب الخدمة إذن وصول المشرف. إذا كانت طلبات البيانات من واجهة برمجة التطبيقات تتطلّب إذن وصول المشرف، يمكنك ترقية إذن الوصول باتّباع الخطوات التالية.

  1. انقر على سهم القائمة المنسدلة بجانب مستوى الوصول الخاص بحساب الخدمة في عمود مستوى الوصول.

  2. اختَر المشرف من القائمة المنسدلة.