إعداد مشروع وحدة تحكم Google API

تعتمد طريقة إنشاء مشروع في Google API Console وإعداده على سيناريو تفويض OAuth 2.0 في تطبيقك. اختَر سيناريو تفويض لتخصيص هذا الدليل.

حسابات الخدمة مصادقة المستخدم

تحتاج إلى مشروع في Google API Console لإنشاء بيانات اعتماد OAuth 2.0 وتفعيل Google Ads API لتطبيقك.

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

اختيار مشروع على Google API Console أو إنشاؤه

ملاحظة: إذا كان لديك مشروع على Google API Console يتيح الوصول إلى واجهة برمجة التطبيقات وتريد استخدامه لإنشاء بيانات اعتماد، يمكنك الانتقال إلى تفعيل Google Ads API في مشروعك.

لإعداد مشروع جديد، اتّبِع الدليل لإنشاء مشروع في Google API Console. تفعيل الفوترة لمشروعك هو إجراء اختياري. إذا كانت الفوترة مفعّلة، اختَر حساب فوترة للمشروع الجديد. لا يتم فرض أي رسوم مقابل استخدام Google Ads API، ولكن تخضع مشاريع على السحابة الإلكترونية لحدود الحصص العادية للمشاريع.

تفعيل Google Ads API في مشروعك

لتفعيل Google Ads API في مشروعك، اتّبِع الخطوات التالية:

1. افتح مكتبة واجهة برمجة التطبيقات في Google API Console. إذا طُلب منك ذلك، اختَر مشروعك أو أنشئ مشروعًا جديدًا. تسرد مكتبة واجهة برمجة التطبيقات جميع واجهات برمجة التطبيقات المتاحة، مجمعة حسب عائلة المنتج والشعبية.

2. استخدِم البحث للعثور على Google Ads API إذا لم تكن ظاهرة في القائمة.

3. اختَر Google Ads API، ثم انقر على الزر تفعيل.

تفعيل Google Ads API

التقدّم بطلب للوصول إلى واجهة برمجة التطبيقات

بعد ذلك، انتقِل إلى صفحة "نظرة عامة" في Google Ads API للاطّلاع على مستوى الوصول الحالي إلى واجهة برمجة التطبيقات. إذا كان مستوى الوصول الحالي إلى واجهة برمجة التطبيقات هو اختبار، وسِّع قسم ترقية مستوى الوصول. اتّبِع التعليمات لتقديم طلب للحصول على مستوى الوصول مستكشف.

بعد إكمال طلبك، تراجعه Google تلقائيًا وتمنحك إذن الوصول إلى Explorer في معظم الحالات.

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

عند استخدام OAuth 2.0 للمصادقة، تعرض Google شاشة طلب الموافقة للمستخدم، وتتضمّن ملخّصًا لمشروعك وسياساته ونطاقات المصادقة المطلوبة للوصول. يؤدي ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth في تطبيقك إلى تحديد ما يتم عرضه للمستخدمين ومراجعي التطبيقات، وتسجيل تطبيقك حتى تتمكّن من نشره لاحقًا.

اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth لتطبيقك وأضِف https://www.googleapis.com/auth/adwords كنطاق OAuth.

اعتبارات مهمة بشأن نوع المستخدم وحالة النشر

عند ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، انتبه إلى إعدادات نوع المستخدم وحالة النشر.

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

لاتخاذ أفضل الخيارات لتطبيقك، راجِع الشروحات التفصيلية والآثار المترتبة على هذه الإعدادات في مستندات الدعم الرسمية من Google Cloud:

• خيارات نوع المستخدم في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
• خيارات حالة نشر شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

من المهم فهم هذه الإعدادات لضمان إمكانية وصول المستخدمين المستهدَفين إلى تطبيقك.

إنشاء معرِّف عميل وسرّ عميل

ملاحظة: إذا كنت تستخدم حاليًا Google APIs أخرى وأنشأت معرّف عميل ورمزًا سريًا للعميل في OAuth 2.0، يمكنك تخطّي هذه الخطوة وإعادة استخدام بيانات الاعتماد الحالية.

أنشئ معرّف عميل وسرّ عميل. يمكنك اختيار تطبيق متوافق مع الكمبيوتر المكتبي أو تطبيق ويب كنوع التطبيق. بعد إنشاء عميل OAuth 2.0، نزِّل ملف JSON الخاص بالعميل من خلال النقر على الزر تنزيل JSON في مربّع حوار التأكيد.