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

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

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

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

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

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

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

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

    generate_user_credentials.py \
      --client_secrets_path=${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. يتم نقلك إلى صفحة تحتوي على رسالة تشير إلى نجاح التفويض.

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

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

    Your refresh token is: 1/Yw.........................................
    Add your refresh token to your client library configuration as described here:
    https://developers.google.com/google-ads/api/docs/client-libs/python/configuration