إعداد مشروع وحدة تحكم Google API لواجهة برمجة التطبيقات مع "إعلانات Google"

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

شاهد هذا الفيديو للاطلاع على بعض أفضل ممارسات مشروع السحاب

إنشاء مشروع

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

تفعيل واجهة برمجة التطبيقات مع "إعلانات Google" في مشروعك

لتمكين إعلانات Google API لمشروعك، اتبع الخطوات التالية:

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

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

  3. حدد إعلانات Google API، ثم انقر على الزر تمكين.

اختيار نوع التطبيق

هناك خياران لنوع التطبيق في إعلانات Google API:

  • تطبيقات سطح المكتب
  • تطبيقات الويب

راجع الجدول أدناه لتحديد أنسب نوع للتطبيق الذي ترغب في إنشائه:

اختيار نوع التطبيق هذا إذا ...
تطبيق متوافق مع أجهزة سطح المكتب
  • أنت تدير جميع حسابات إعلانات Google باستخدام حساب مدير واحد بمستوى أعلى.
  • إذا كنت تستخدم التطبيق للمرة الأولى، أو كنت تريد البدء بسرعة باستخدام أبسط عملية إعداد.
  • لن يصادق تطبيقك إلا مستخدمي Google من جهاز واحد.
تطبيق الويب
  • وتريد المصادقة بصفتك مستخدمًا يمكنه منح الإذن لتطبيقك للوصول إلى بيانات حسابه في إعلانات Google.
  • إذا كنت تريد إنشاء عدة بيانات اعتماد للتفويض بسهولة لإدارة حسابات الجهات الخارجية مثلاً.
  • يتطلب تطبيقك عناوين URL لرد الاتصال، حيث إن عناوين URL لمعاودة الاتصال غير متاحة في مسار تطبيق سطح المكتب.

للتعرُّف على المزيد من التفاصيل، يُرجى الاطِّلاع على وثائق بروتوكول OAuth في منصّة Google Identity بخصوص تطبيقات سطح المكتب أو تطبيقات الويب.

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

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

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

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

    1. إذا لم تكن قد هيأت شاشة موافقة OAuth لهذا المشروع من قبل، فسيتم توجيهك لإجراء ذلك الآن. انقر على تهيئة شاشة الموافقة.

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

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

    2. ارجع إلى بيانات الاعتماد > إنشاء بيانات الاعتماد > معرِّف عميل OAuth للمتابعة.

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

  4. أدخل اسمًا لها، ثم انقر على إنشاء.

  5. إذا كان نوع برنامجك هو تطبيق ويب، أضِف على الأقل معرّف موارد منتظمًا (URI) مُعاد تفويضه لإعادة التوجيه.

    لإجراء اختبار محلي متوافق مع الضبط التلقائي في أمثلة مكتبة البرامج، استخدِم http://127.0.0.1.

    بالنسبة إلى برامج تطبيقات سطح المكتب، ستظل تستخدم إعادة توجيه IP، ولكن لم تتم تهيئة معرف الموارد المنتظم (URI) بشكل صريح في Cloud Console.

  6. في صفحة التأكيد، انسخ رقم تعريف العميل وسر العميل إلى الحافظة، حيث ستحتاج إليهما عند تهيئة مكتبة العميل. يمكنك أيضًا الرجوع إلى صفحة بيانات الاعتماد لاحقًا لاسترداد هذه التفاصيل.