يرشدك هذا الدليل إلى كيفية إعداد OAuth2 للوصول إلى واجهة برمجة التطبيقات باستخدام بيانات الاعتماد الخاصة بك وإما تدفق سطح المكتب أو تدفق الويب. يجب تنفيذ هذه الخطوات مرة واحدة فقط، ما لم يتم إبطال النطاقات المسموح بها أو حذفها أو تغيير النطاقات المسموح بها لبيانات اعتماد OAuth2.
إنشاء بيانات اعتماد OAuth2
اتّبِع الخطوات من أجل ضبط مشروع وحدة تحكّم Google API على واجهة Google Ads API.
نزِّل ملف 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". انقر على متابعة في شاشة طلب الموافقة المتعلّقة ببروتوكول 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