يرشدك هذا الدليل إلى كيفية إعداد OAuth 2.0 للوصول إلى واجهة برمجة التطبيقات باستخدام بيانات الاعتماد الخاصة بك وعملية سطح المكتب أو عملية الويب. يجب اتّباع هذه الخطوات مرة واحدة فقط، ما لم يتم إبطال أو حذف أو تغيير النطاقات المسموح بها لبيانات اعتماد OAuth 2.0.
إنشاء بيانات اعتماد OAuth 2.0
اتّبِع الخطوات لضبط مشروع على Google API Console من أجل Google Ads API.
سجِّل معرّف العميل وسر العميل، ثم ارجع إلى هذه الصفحة.
إعداد مكتبة البرامج
-
في ملف
google_ads_config.rb
، أدخِل معرّف العميل وسر العميل اللذين حصلت عليهما في الخطوة السابقة.c.client_id = INSERT_OAUTH2_CLIENT_ID_HERE c.client_secret = INSERT_OAUTH2_CLIENT_SECRET_HERE
-
في الوحدة الطرفية، شغِّل مثال الرمز
generate_user_credentials.rb
.ruby generate_user_credentials.rb -P /path/to/client_secrets.json
-
يطلب منك مثال الرمز البرمجي هذا الانتقال إلى عنوان 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.
سيتم توجيهك إلى صفحة تتضمّن رسالة تشير إلى أنّ عملية التفويض تمت بنجاح.
Your refresh token has been fetched. Check the console output for further instructions.
-
ارجع إلى وحدة التحكّم التي يتم فيها تشغيل المثال. ستلاحظ أنّ المثال قد اكتمل ويعرض رمز التحديث وبعض التعليمات، يليها التعليمات التي عليك اتّباعها لإعداد مكتبة البرامج:
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
انسخ رمز التحديث إلى ملف
google_ads_config.rb
.