يرشدك هذا الدليل إلى كيفية إعداد OAuth2 للدخول إلى واجهة برمجة التطبيقات باستخدام بيانات اعتمادك الخاصة وإما تدفق سطح المكتب أو تدفق الويب. يجب تنفيذ هذه الخطوات مرة واحدة فقط، ما لم يتم إبطال أو حذف أو تغيير النطاقات المسموح بها لبيانات اعتماد OAuth2.
إنشاء بيانات اعتماد OAuth2
اتّبِع الخطوات من أجل إعداد مشروع وحدة تحكّم Google API لواجهة برمجة التطبيقات مع Google Ads API.
دوِّن معرِّف العميل والسرية، ثم ارجع إلى هذه الصفحة.
إعداد مكتبة البرامج
في وحدة طرفية، انتقِل إلى مثال OAuth2.
شغِّل هذا المثال باستخدام سطر الأوامر. يمكنك إما تعديل قيم
INSERT_XXX_HEREفي المثال قبل التشغيل أو استخدام الوسيطات-client_idلمعرِّف العميل و-client_secretلسر العميل.perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}يطلب منك المثال الانتقال إلى عنوان URL الذي ستحتاج فيه إلى السماح لبيانات اعتماد OAuth2 بالوصول إلى حسابك على "إعلانات Google" بالنيابة عنك.
Paste this url in your browser: https://accounts.google.com/o/oauth2/v2/auth?response_type=code&access_type=offline&client_id=...انتقِل إلى عنوان URL في جلسة متصفّح خاصة أو في نافذة التصفّح المتخفي. سجِّل الدخول باستخدام حساب Google نفسه الذي تستخدمه للوصول إلى "إعلانات Google". انقر على متابعة في شاشة طلب الموافقة في OAuth2.
يتم نقلك إلى صفحة تحتوي على رسالة تشير إلى نجاح التفويض.
Authorization code was successfully retrieved.سترى أنّ المثال اكتمل وأنّ الرمز المميّز للتحديث معروض مع بعض التعليمات في الصفحة نفسها، متبوعة بالسمات التي ستحتاج إليها لإعداد مكتبة البرامج:
Replace the following keys and values in your googleads.properties configuration file: clientId==***********************apps.googleusercontent.com clientSecret=**** refreshToken=****ارجع إلى وحدة التحكّم التي تشغِّل فيها المثال، واضغط على
Ctrl + Cلإنهاء العملية. بعد ذلك، انسخ الرمز المميّز لإعادة التحميل الذي تم إنشاؤه مع معرّف العميل وسر العميل فيgoogleads.propertiesأو احفظه في مكان آخر لاستخدامه في حال إنشاء نسخة افتراضية من المكتبة في وقت التشغيل.