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

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

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

اختيار أو إنشاء مشروع وحدة التحكم في واجهة Google API

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

لإنشاء مشروع،

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

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

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

عند استخدام 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 الذي يحتوي على معرّف وسر عميل تم إنشاؤهما.

بعد تحديد نوع تطبيقك، اتّبِع التعليمات أدناه لإنشاء معرِّف عميل 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"