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

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

إنشاء بيانات اعتماد OAuth 2.0

  1. اتّبِع الخطوات لضبط مشروع على Google API Console من أجل Google Ads API.

  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 حيث يجب أن تمنح التطبيق الإذن بالوصول إلى حسابك على "إعلانات Google" نيابةً عنك.

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

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

    شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth 2.0

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

    Your refresh token has been fetched. Check the console output for further instructions.

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

    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