تعتمد خطوات إنشاء مشروع في 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". اختَر مشروعك أو أنشئ مشروعًا جديدًا إذا طُلب منك ذلك. تعرض "مكتبة واجهات برمجة التطبيقات" جميع واجهات برمجة التطبيقات المتاحة، ويتم تجميعها حسب فئة المنتج ومدى رواجها.
استخدِم البحث للعثور على 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:
- خيارات نوع المستخدم في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
- خيارات حالة نشر شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
ومن الضروري فهم هذه الإعدادات لضمان إمكانية وصول المستخدمين المستهدَفين إلى تطبيقك.
إنشاء معرّف عميل وسرّ عميل
يمكنك تخطّي هذه الخطوة إذا كنت تستخدم مشروعًا حاليًا في Google API Console يتضمّن معرّف عميل وسر عميل تم إنشاؤهما من قبل. وإلا، أنشئ معرّف عميل وسر عميل باتّباع التعليمات. يمكنك اختيار تطبيق سطح المكتب أو تطبيق الويب كنوع التطبيق. بعد إنشاء عميل OAuth 2.0، نزِّل ملف JSON الخاص بالعميل من خلال النقر أولاً على رمز تنزيل عميل OAuth، ثم على الزر تنزيل JSON في الشاشة التالية.