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

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

إنشاء بيانات اعتماد OAuth2 لحساب واحد

أسهل طريقة لإجراء مكالمات إلى حسابات Google Ads API هي

1. اربط جميع الحسابات التي تريد إجراء طلبات بيانات من واجهة برمجة التطبيقات بها ضمن حساب إداري واحد على "إعلانات Google".

2. يمكنك استخدام مثال GenerateUserCredentials لإنشاء بيانات اعتماد OAuth2 لمستخدم لديه إمكانية الوصول إلى الحساب الإداري.

3. استخدِم بيانات اعتماد OAuth2 لإجراء اتصالات بجميع الحسابات التي تحتاج إلى إدارتها باستخدام Google Ads API.

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

الخطوة 1 - إنشاء بيانات اعتماد OAuth2

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

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

الخطوة 2: إعداد مكتبة البرامج

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

   هذا مثال تفاعلي سيتطلب منك تقديم إدخال.

   dotnet run GenerateUserCredentials.csproj
   

2. في المثال التالي، سيُطلب منك تقديم معرّف العميل وسر OAuth2. قدِّم التفاصيل من الخطوة 1.

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

   

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

   تم استرجاع الرمز المميّز لإعادة التحميل. تحقق من مخرجات وحدة التحكم للحصول على مزيد من التعليمات.

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

   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 = '******' />
   
   Make sure you also set the LOGIN_CUSTOMER_ID header. See
   https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
   to learn more.
   
   <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
   
   See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
   for alternate configuration options.
   

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

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