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

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

إنشاء بيانات اعتماد OAuth 2.0

1. اتّبِع الخطوات لضبط مشروع على Google API Console لواجهة برمجة التطبيقات Google Ads API.

2. سجِّل معرِّف العميل وسر العميل، ثم ارجع إلى هذه الصفحة.

إعداد مكتبة العميل

1. في وحدة طرفية، شغِّل مثال GenerateUserCredentials. أدخِل معرِّف عميل OAuth 2.0 وسر العميل عند طلب ذلك.

   dotnet run GenerateUserCredentials.csproj
   

2. يفتح مثال الرمز البرمجي هذا عنوان URL تلقائيًا في المتصفّح. إذا لم تكن مسجِّلاً الدخول إلى جلسة المتصفّح، ستطلب منك صفحة الويب تسجيل الدخول إلى حسابك على Google. إذا سبق لك تسجيل الدخول، سيتخطّى التطبيق طلب تسجيل الدخول ويعيد توجيهك إلى عنوان URL حيث يجب منح التطبيق الإذن بالوصول إلى حسابك على "إعلانات Google" نيابةً عنك.

   سجِّل الدخول باستخدام حساب Google الذي تستخدمه للوصول إلى "إعلانات Google". وعادةً ما يكون هذا الرابط عبارة عن بريد إلكتروني لتسجيل الدخول إلى حساب إداري على "إعلانات Google" يحتوي على جميع الحسابات التي تحتاج إلى إدارتها ضمن التدرّج الهرمي للحساب. انقر على متابعة في شاشة طلب الموافقة على بروتوكول OAuth 2.0.

   

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

   Your refresh token has been fetched. Check the
   console output for further instructions.

3. ارجع إلى وحدة التحكّم التي تُشغّل فيها مثال الرمز البرمجي. ستلاحظ أنّه تم إكمال مثال الرمز المبرمَج وأنّه يعرض رمز إعادة التنشيط وبعض التعليمات، متبوعًا بالتعليمات التي عليك اتّباعها لضبط مكتبة العميل:

   Copy the following content into your App.config file.
   
   <add key = 'OAuth2Mode' value = 'APPLICATION' />
   <add key = 'OAuth2ClientId' value = '******' />
   <add key = 'OAuth2ClientSecret' value = '******' />
   <add key = 'OAuth2RefreshToken' value = '******' />
   

   تأكَّد أيضًا من ضبط عنوان LOGIN_CUSTOMER_ID في ملف App.config. اطّلِع على دليل الإعداد لمزيد من المعلومات.

   <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
   

   يُرجى الرجوع إلى دليل الإعداد للاطّلاع على خيارات الضبط البديلة.

إنشاء بيانات اعتماد OAuth2 للتطبيقات التفاعلية

إذا لم تكن تعرف حساب "إعلانات Google" الذي تريد إجراء طلبات بيانات من واجهة برمجة التطبيقات إليه مسبقًا، يمكنك اكتشافه أثناء التشغيل باستخدام بيانات اعتماد المستخدم الذي سجّل الدخول إلى الجلسة. راجِع ملف برمجة التطبيقات AuthenticateInAspNetCoreApplication للاطّلاع على مثال لمصادقة المستخدم الذي سجّل الدخول حاليًا والحصول على بيانات اعتماد OAuth2 أثناء التشغيل.