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