إعداد مشروع وحدة تحكم 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. تفعيل الفوترة لمشروعك هو إجراء اختياري. إذا كانت الفوترة مفعَّلة، اختَر حساب فوترة للمشروع الجديد. لا يتم فرض أي رسوم مقابل استخدام 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 تلقائيًا وتمنحك إذن الوصول إلى الإصدار التجريبي في معظم الحالات.

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول 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 في مربّع حوار التأكيد.