يرشدك هذا الدليل إلى كيفية إعداد OAuth2 للدخول إلى واجهة برمجة التطبيقات باستخدام بيانات الاعتماد الخاصة بك وإما تدفق سطح المكتب أو تدفق الويب. يجب تنفيذ هذه الخطوات مرة واحدة فقط، ما لم تُلغِ أو تحذف أو تحتاج إلى تغيير النطاقات المسموح بها لبيانات اعتماد OAuth2.
إنشاء بيانات اعتماد OAuth2
اتبع الخطوات لتهيئة مشروع وحدة تحكم Google API لواجهة برمجة التطبيقات مع "إعلانات Google".
نزِّل ملف JSON للعميل من خلال النقر أولاً على رمز تنزيل عميل OAuth، ثم على زر تنزيل JSON على الشاشة التالية.
احفظ الملف في دليلك الرئيسي بحيث يكون لديك الآن الملف المحلي
~/client_secret_XXX.apps.googleusercontent.com.json(حيث ستكون XXX قيّمًا خاصة بمشروعك). سنستخدم هذا الملف في الخطوة التالية لتشغيل مثال الشفرة.
إعداد مكتبة العميل
في الوحدة الطرفية، شغِّل مثال
generate_user_credentials. استخدم علامات سطر الأوامر لتمريره إلى ملف JSON الذي تم تنزيله في الخطوة السابقة.generate_user_credentials.py \ --client_secrets_path=${HOME}/client_secret_XXX.apps.googleusercontent.com.jsonيطالبك المثال بزيارة عنوان URL حيث ستحتاج إلى السماح لبيانات اعتماد OAuth2 بالوصول إلى حسابك في إعلانات Google نيابةً عنك.
Paste this URL in your browser: https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...انتقِل إلى عنوان URL في جلسة متصفِّح خاص أو في نافذة التصفُّح المتخفي. سجِّل الدخول باستخدام حساب Google نفسه الذي تستخدمه للوصول إلى "إعلانات Google". انقر على Continue (متابعة) في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth2.
يتم نقلك بعد ذلك إلى صفحة بها رسالة تشير إلى نجاح التفويض.
تم جلب الرمز المميز للتحديث. راجع مخرجات وحدة التحكم للاطلاع على مزيد من الإرشادات.
ارجع إلى وحدة التحكم التي شغّلت فيها المثال، والتي يجب أن تعرض الآن الرمز المميز للتحديث وبعض الإرشادات لتهيئة مكتبة العميل:
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