تدفقات OAuth على سطح المكتب وتطبيقات الويب

يرشدك هذا الدليل إلى كيفية إعداد OAuth2 للدخول إلى واجهة برمجة التطبيقات باستخدام بيانات الاعتماد الخاصة بك وإما جهاز سطح المكتب التدفق أو الويب التدفق. يجب تنفيذ هذه الخطوات فقط مرة واحدة، ما لم يتم إبطال النطاقات المسموح بها أو حذفها أو تغييرها بيانات اعتماد OAuth2.

إنشاء بيانات اعتماد OAuth2

1. اتّبِع الخطوات لضبط مشروع وحدة تحكّم واجهة برمجة تطبيقات Google من أجل Google Ads API:

2. نزِّل ملف JSON للعميل من خلال النقر أولاً على تنزيل بروتوكول OAuth الخاص به. العميل ثم على الزر DOWNLOAD JSON على الشاشة التالية.

   احفظ الملف في الدليل الرئيسي حتى يكون لديك الآن الملف المحلي ~/client_secret_XXX.apps.googleusercontent.com.json (حيث سيكون XXX القيم الخاصة بمشروعك). سنستخدم هذا الملف في الخطوة التالية لتشغيل مثال التعليمة البرمجية.

إعداد مكتبة البرامج

1. في نافذة طرفية، شغِّل GenerateUserCredentials مثال. استخدِم علامات سطر الأوامر لتمرير ملف JSON الذي نزّلته إليه. الخطوة السابقة.

   للتشغيل من سطر الأوامر باستخدام Gradle

   ./gradlew --console=plain --quiet runExample \
     --example="authentication.GenerateUserCredentials \
     --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
   

2. سيطلب منك المثال الانتقال إلى عنوان 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.

   

3. سيتم نقلك إلى صفحة تتضمن رسالة تشير إلى أن التفويض تم بنجاح.

   تم استرداد رمز التفويض بنجاح.

   يُرجى الاطّلاع على نتيجة وحدة التحكّم من GenerateUserCredentials للحصول على مزيد من التعليمات.

4. ارجع إلى وحدة التحكّم التي يتم تشغيل المثال فيها. سترى أن اكتمل التحديث ويعرض الرمز المميز للتحديث وبعض التعليمات، متبوعة بالخصائص التي ستحتاج إلى تهيئة مكتبة البرامج:

   #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=........................
   

5. انسخ السطور من تعليق التاريخ # إلى نهاية الإخراج إلى ملف ads.properties.

   استبدِل INSERT_DEVELOPER_TOKEN_HERE بالرمز المميز للمطوِّر.

   لإجراء الإعداد بسهولة، ضَع ملف ads.properties في منزلك. الدليل.