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

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

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

  1. اتّبِع خطوات ضبط مشروع Google Play Console لواجهة برمجة التطبيقات مع "إعلانات 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 أو احفظه في أي مكان آخر لاستخدامه في حال إنشاء مثيل للمكتبة في وقت التشغيل.