تدفقات 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 في وقت التشغيل.