تعتمد طريقة إنشاء مشروع في "وحدة تحكّم Google API" وضبط إعداداته على سيناريو تفويض OAuth 2.0 الخاص بتطبيقك. اختَر سيناريو تفويض لتخصيص هذا الدليل.
تحتاج إلى مشروع في Google API Console لإنشاء بيانات اعتماد OAuth 2.0 وتفعيل Google Ads API لتطبيقك.
تتيح بيانات الاعتماد هذه مصادقة المستخدمين في تطبيقك أو في "إعلانات Google" وتفويضهم على خوادم Google، كما تتيح لك إنشاء رموز مميّزة لبروتوكول OAuth لاستخدامها في طلبات البيانات من واجهة برمجة التطبيقات.
اختيار مشروع أو إنشاء مشروع في Google API Console
لإعداد مشروع جديد، اتّبِع الدليل لإنشاء مشروع في وحدة تحكّم Google API. تفعيل الفوترة لمشروعك هو إجراء اختياري. إذا كانت الفوترة مفعّلة، اختَر حساب فوترة للمشروع الجديد. لا يتم تحصيل أي رسوم مقابل استخدام Google Ads API، ولكن تخضع مشاريع Cloud لحدود الحصة المخصّصة للمشاريع العادية.
تفعيل Google Ads API في مشروعك
لتفعيل Google Ads API في مشروعك، اتّبِع الخطوات التالية:
افتح "مكتبة واجهات برمجة التطبيقات" في "وحدة تحكّم Google API". إذا طُلب منك ذلك، اختَر مشروعك أو أنشئ مشروعًا جديدًا. تسرد "مكتبة واجهات برمجة التطبيقات" جميع واجهات برمجة التطبيقات المتاحة، ويتم تجميعها حسب فئة المنتج ومدى الرواج.
استخدِم البحث للعثور على Google Ads API إذا لم يكن ظاهرًا في القائمة.
اختَر Google Ads API، ثمّ انقر على الزر تفعيل.
تقديم طلب للوصول إلى واجهة برمجة التطبيقات
بعد ذلك، انتقِل إلى صفحة "نظرة عامة" في Google Ads API للاطّلاع على مستوى الوصول الحالي إلى واجهة برمجة التطبيقات. إذا كان مستوى الوصول الحالي إلى واجهة برمجة التطبيقات هو اختبار، وسِّع قسم ترقية مستوى الوصول. اتّبِع التعليمات لتقديم طلب للحصول على مستوى الوصول Explorer.
بعد إكمال طلبك، ستراجعه Google تلقائيًا وتمنحك إذن الوصول إلى الإصدار التجريبي في معظم الحالات.
إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
عند استخدام OAuth 2.0 للحصول على إذن الوصول، يعرض محرّك بحث Google شاشة طلب الموافقة للمستخدم تتضمّن ملخّصًا لمشروعك وسياساته ونطاقات إذن الوصول المطلوبة. يحدّد ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth في تطبيقك المحتوى الذي يظهر للمستخدمين ومراجعي التطبيقات، كما يسجّل تطبيقك لتتمكّن من نشره لاحقًا.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth لتطبيقك وإضافة https://www.googleapis.com/auth/adwords كنطاق OAuth
اعتبارات مهمة بشأن نوع المستخدم وحالة النشر
عند ضبط شاشة طلب الموافقة لبروتوكول OAuth، انتبه إلى إعدادَي نوع المستخدم وحالة النشر.
- نوع المستخدم: يحدّد ما إذا كان تطبيقك متاحًا فقط للمستخدمين داخل مؤسستك (داخلي) أو لأي مستخدم على Google (خارجي). لا يتوفّر الخيار داخلي إلا إذا كان مشروعك جزءًا من مؤسسة Google Workspace.
- حالة النشر: تحدّد ما إذا كان التطبيق في وضع الاختبار (يقتصر على مستخدمي الاختبار المحدّدين الذين تضيفهم) أو في مرحلة الإنتاج (متاح لشريحة الجمهور المحدّدة حسب نوع المستخدم، وقد يتطلّب ذلك التحقق من التطبيقات من Google).
لاتّخاذ أفضل الخيارات لتطبيقك، راجِع الشروحات التفصيلية والآثار المترتبة على هذه الإعدادات في مستندات الدعم الرسمية من Google Cloud:
- خيارات نوع مستخدم شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- خيارات حالة نشر شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
من الضروري فهم هذه الإعدادات لضمان إمكانية وصول المستخدمين المستهدَفين إلى تطبيقك.
إنشاء معرّف عميل وسر عميل
أنشئ معرّف عميل وسر عميل. يمكنك اختيار تطبيق سطح المكتب أو تطبيق الويب كنوع التطبيق. بعد إنشاء عميل OAuth 2.0، نزِّل ملف JSON الخاص بالعميل من خلال النقر على الزر تنزيل JSON في مربّع حوار التأكيد.