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

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

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

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

  2. نزِّل ملف JSON الخاص بأسرار العميل وضعه في مكان يمكن الوصول إليه من الرمز البرمجي.

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

  1. في ملف google_ads_config.rb، أدخِل معرّف العميل وسر العميل الخاصين بك. يمكن العثور عليها في ملف جسون الذي تم تنزيله أعلاه.

    c.client_id = INSERT_OAUTH2_CLIENT_ID_HERE
    c.client_secret = INSERT_OAUTH2_CLIENT_SECRET_HERE
    
  2. في وحدة طرفية، شغِّل مثال OAuth2:

    ruby generate_user_credentials.rb -P /path/to/client_secrets.json
    
  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. يتم نقلك بعد ذلك إلى صفحة تحتوي على رسالة تشير إلى التفويض تم بنجاح.

  5. ارجع إلى وحدة التحكّم التي كنت تُشغّل فيها المثال. من المفترض أن يكون المثال قد اكتمل وأن يعرض الرمز المميّز لإعادة التحميل. نسخ الرمز المميّز لإعادة التحميل في ملف google_ads_config.rb.