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