تدفقات OAuth على سطح المكتب وتطبيقات الويب

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

إنشاء بيانات اعتماد OAuth2

  1. اتّبِع الخطوات من أجل ضبط مشروع على وحدة تحكُّم Google API لواجهة برمجة التطبيقات مع "إعلانات Google".

  2. دوِّن معرّف العميل والسرية، ثم ارجع إلى هذه الصفحة.

إعداد مكتبة العملاء

  1. في الوحدة الطرفية، انتقِل إلى مثال OAuth2.

  2. شغِّل هذا المثال باستخدام سطر الأوامر. يمكنك إما تعديل قيم INSERT_XXX_HERE في المثال قبل التشغيل أو استخدام الوسيطات -client_id لمعرّف العميل و-client_secret لسر العميل.

    perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}

  3. يطالبك المثال بزيارة عنوان URL حيث ستحتاج إلى السماح لبيانات اعتماد OAuth2 بالوصول إلى حسابك على "إعلانات Google" بالنيابة عنك.

    Paste this url in your browser:
https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...

    انتقِل إلى عنوان URL في جلسة متصفّح خاصة أو في نافذة تصفّح متخفٍ. سجِّل الدخول باستخدام حساب Google نفسه الذي تستخدمه للوصول إلى "إعلانات Google". انقر على متابعة في شاشة طلب الموافقة OAuth2.

    شاشة الموافقة

  4. يتم نقلك بعد ذلك إلى صفحة تحتوي على رسالة تشير إلى نجاح التفويض.

    Authorization code was successfully retrieved.

    ستلاحظ اكتمال النموذج وعرض الرمز المميّز للتحديث مع بعض التعليمات في الصفحة نفسها، متبوعة بالخصائص التي ستحتاج إليها لإعداد مكتبة العملاء:

    Replace the following keys and values in your googleads.properties configuration file:

clientId==***********************apps.googleusercontent.com
clientSecret=****
refreshToken=****

  5. ارجع إلى وحدة التحكّم التي تشغِّل فيها المثال، واضغط على Ctrl + C لإنهاء العملية. بعد ذلك، انسخ الرمز المميّز لإعادة التحميل الذي تم إنشاؤه مع معرّف العميل وسر العميل في googleads.properties أو احفظه في مكان آخر لاستخدامه في حال إنشاء مثيل للمكتبة في وقت التشغيل.