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