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

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

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

  1. اتّبِع خطوات ضبط مشروع Google Play Console لواجهة برمجة التطبيقات مع "إعلانات Google".

  2. نزِّل ملف JSON للعميل عن طريق النقر أولاً على رمز تنزيل عميل OAuth ثم على زر تنزيل JSON في الشاشة التالية.

    احفظ الملف في الدليل الرئيسي حتى يصبح لديك الملف المحلي الآن ~/client_secret_XXX.apps.googleusercontent.com.json (حيث ستكون XXX قيمًا لمشروعك). سنستخدم هذا الملف في الخطوة التالية لتنفيذ مثال الرمز.

إعداد مكتبة البرامج

  1. في الوحدة الطرفية، شغِّل المثال GenerateUserCredentials. استخدم علامات سطر الأوامر لتمرير ملف JSON الذي نزّلته في الخطوة السابقة.

    التشغيل من سطر الأوامر باستخدام Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. وسيطلب منك المثال زيارة عنوان URL حيث ستحتاج إلى السماح لبيانات اعتماد OAuth2 بالوصول إلى حسابك على "إعلانات Google" نيابةً عنك.

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
    

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

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

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

    تم استرداد رمز التفويض بنجاح.

    تحقَّق من المخرجات في وحدة التحكّم من GenerateUserCredentials للحصول على المزيد من التعليمات.

  4. ارجع إلى وحدة التحكّم التي تشغّل فيها المثال. ستلاحظ أنّ المثال قد اكتمل ويعرض رمزك المميّز لإعادة التحميل وبعض التعليمات، يليها السمات التي ستحتاج إليها لضبط مكتبة البرامج:

    #Mon Apr 18 09:07:51 EDT 2022
    api.googleads.refreshToken=1/Yw.........................................
    api.googleads.clientId=...........-...............apps.googleusercontent.com
    api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
    api.googleads.clientSecret=........................
    
  5. انسخ الأسطر من تاريخ التعليق # إلى نهاية الإخراج إلى ملف ads.properties.

    استبدِل INSERT_DEVELOPER_TOKEN_HERE بالرمز المميّز للمطوِّر.

    لإجراء الإعداد بسهولة، ضَع الملف ads.properties في الدليل الرئيسي.