يرشدك هذا الدليل إلى كيفية إعداد OAuth2 للوصول إلى واجهة برمجة التطبيقات باستخدام بيانات الاعتماد الخاصة بك وإما تدفق سطح المكتب أو تدفق الويب. يجب تنفيذ هذه الخطوات مرة واحدة فقط ما لم يتم إبطال النطاقات المسموح بها لبيانات اعتماد OAuth2 أو حذفها أو الحاجة إلى تغييرها.
إنشاء بيانات اعتماد OAuth2
اتّبِع الخطوات من أجل ضبط مشروع وحدة تحكّم Google API على واجهة Google Ads API.
نزِّل ملف JSON الخاص بالعميل من خلال النقر أولاً على رمز تنزيل عميل OAuth ثم على زر تنزيل JSON على الشاشة التالية.
احفظ الملف في الدليل الرئيسي بحيث يكون لديك الآن الملف المحلي
~/client_secret_XXX.apps.googleusercontent.com.json(حيث سيكون XXX قيمًا خاصة بمشروعك). سنستخدم هذا الملف في الخطوة التالية لتشغيل مثال التعليمة البرمجية.
إعداد مكتبة البرامج
في الوحدة الطرفية، شغِّل مثال
GenerateUserCredentials. استخدم علامات سطر الأوامر لتمرير ملف JSON الذي قمت بتنزيله في الخطوة السابقة إليه.للتشغيل من سطر الأوامر باستخدام Gradle
./gradlew --console=plain --quiet runExample \ --example="authentication.GenerateUserCredentials \ --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"سيطلب منك المثال الانتقال إلى عنوان URL حيث عليك السماح لبيانات اعتماد OAuth2 بالوصول إلى حسابك على "إعلانات Google" نيابةً عنك.
Paste this URL in your browser: https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...انتقِل إلى عنوان URL في جلسة متصفّح بخصوصيّة تامّة أو في نافذة التصفّح المتخفي. سجِّل الدخول بحساب Google نفسه الذي تستخدمه للوصول إلى "إعلانات Google". انقر على متابعة في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth2.
سيتم نقلك إلى صفحة تتضمن رسالة تشير إلى نجاح التفويض.
تم استرداد رمز التفويض بنجاح.
يُرجى الاطّلاع على نتيجة وحدة التحكّم من
GenerateUserCredentialsللحصول على مزيد من التعليمات.ارجع إلى وحدة التحكّم التي يتم تشغيل المثال فيها. ستلاحظ أنّ المثال قد اكتمل ويعرِض الرمز المميّز لإعادة التحميل وبعض التعليمات، متبوعة بالخصائص التي ستحتاج إليها لإعداد مكتبة البرامج:
#Mon Apr 18 09:07:51 EDT 2022 api.googleads.refreshToken=1/Yw......................................... api.googleads.clientId=...........-...............apps.googleusercontent.com api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE api.googleads.clientSecret=........................انسخ السطور من تعليق التاريخ
#إلى نهاية النتائج إلى ملفads.properties.استبدِل
INSERT_DEVELOPER_TOKEN_HEREبالرمز المميز للمطوِّر.لإجراء الإعداد بسهولة، ضَع ملف
ads.propertiesفي دليل الصفحة الرئيسية.