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