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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • عنوان البريد الإلكتروني لحساب العميل الذي سجّلت الدخول إليه. وهذا الإجراء ضروري لإنشاء الرمز المميّز لإعادة تحميل بروتوكول OAuth 2.0.

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