يرشدك هذا الدليل إلى كيفية إعداد 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