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

تحتاج إلى مشروع وحدة تحكُّم Google API لإنشاء بيانات اعتماد OAuth 2.0، وضبط شاشة موافقة المستخدم، وتفعيل Google Ads API لتطبيقك.

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

اختيار مشروع وحدة تحكُّم Google API أو إنشاؤه

إذا كان لديك مشروع على وحدة تحكُّم واجهة Google API وتريد استخدامه لإنشاء بيانات اعتماد، يمكنك التخطّي إلى إنشاء معرّف عميل وسر عميل.

لكي تُنشئ مشروعًا،

  • انتقِل إلى وحدة التحكم في واجهة Google API.
  • انقر على إنشاء مشروع.
  • يُرجى إدخال اسم أو قبول الاقتراح الذي تم إنشاؤه.
  • يُرجى تأكيد أي حقول متبقية أو تعديلها.
  • انقر على إنشاء

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

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

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

  1. افتح صفحة شاشة الموافقة واختَر مشروعك في القائمة المنسدلة في أعلى الصفحة.
  2. اختَر نوع المستخدِم وانقر على إنشاء.
  3. املأ نموذج شاشة الموافقة. ويمكنك تعديلها في وقت لاحق إذا لزم الأمر. انقر على حفظ ومتابعة عند الانتهاء.
  4. في الصفحة التالية، انقر على إضافة الملخّصات أو إزالتها.
  5. انتقِل للأسفل وأدخِل ما يلي في الحقل ضمن إضافة النطاقات يدويًا:

    https://www.googleapis.com/auth/adwords

  6. انقر على إضافة إلى الجدول.
  7. أضِف أي نطاقات أخرى قد يحتاجها مشروعك، ثم انقر على تعديل.
  8. انقر على حفظ ومتابعة.
  9. إذا لم تكن تخطّط لنشر مشروعك على الفور، أضِف عنوان البريد الإلكتروني لكل حساب مستخدم قد تستخدمه في الاختبار، ثم انقر على حفظ ومتابعة.
  10. راجِع صفحة الملخّص وانقر على الرجوع إلى لوحة البيانات.
  1. افتح صفحة شاشة الموافقة واختَر مشروعك في القائمة المنسدلة في أعلى الصفحة.
  2. انقر على تعديل التطبيق.
  3. انقر على حفظ ومتابعة في نموذج شاشة موافقة OAuth.
  4. في الصفحة التالية، انقر على إضافة الملخّصات أو إزالتها.
  5. انتقِل للأسفل وأدخِل ما يلي في الحقل ضمن إضافة النطاقات يدويًا:

    https://www.googleapis.com/auth/adwords

  6. انقر على إضافة إلى الجدول.
  7. انقر على حفظ ومتابعة.
  8. انقر على حفظ ومتابعة في نموذج المستخدمون التجريبيون.
  9. راجِع صفحة الملخّص وانقر على الرجوع إلى لوحة البيانات.

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

يمكنك تخطّي هذه الخطوة إذا كنت تستخدم مشروعًا حاليًا في وحدة تحكّم Google API يتضمّن معرّف عميل وسر تم إنشاؤهما.

بعد تحديد نوع تطبيقك، يمكنك اتّباع التعليمات الواردة أدناه لإنشاء معرّف عميل OAuth 2.0 وسر العميل:

  1. افتح صفحة بيانات الاعتماد. اختَر مشروعًا تم إنشاؤه سابقًا أو أنشِئ مشروعًا جديدًا.

  2. في شاشة "بيانات الاعتماد"، انقر على إنشاء بيانات الاعتماد، ثم اختَر معرِّف عميل OAuth.

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

      • اختَر نوع المستخدِم وانقر على إنشاء.

      • املأ النموذج الأولي. ويمكنك تعديلها في وقت لاحق إذا لزم الأمر. انقر على حفظ عند الانتهاء.

    • انتقِل مرة أخرى إلى بيانات الاعتماد > إنشاء بيانات الاعتماد > معرِّف عميل OAuth للمتابعة.

  3. اختَر تطبيق سطح المكتب أو تطبيق ويب كنوع التطبيق، حسب حالة الاستخدام. يستخدم هذا الدليل تطبيق سطح المكتب كنوع التطبيق.

  4. املأ اسمًا للتطبيق، ثم انقر على إنشاء.

  5. في صفحة التأكيد، انسخ معرّف العميل وسر العميل إلى الحافظة لإعداد مكتبة البرامج لاحقًا. يمكنك أيضًا تنزيل بيانات الاعتماد بتنسيق JSON إلى ملف باسم credentials.json.

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

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

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

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

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

السابق
الحصول على رمز مميز للمطوِّر
التالي
تجهيز حساب "إعلانات Google"