مسارات OAuth لسطح تطبيق الويب

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

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

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

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

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

3. استخدم بيانات اعتماد OAuth2 لإجراء مكالمات لجميع الحسابات التي تحتاج إلى إدارتها باستخدام إعلانات Google 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 نيابةً عنك.

   ملاحظة: سجِّل الدخول باستخدام حساب Google نفسه الذي تستخدمه للوصول إلى "إعلانات Google". وعادةً ما يكون هذا هو عنوان البريد الإلكتروني لتسجيل الدخول إلى حساب إداري على "إعلانات 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 في وقت التشغيل.