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