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

تحذير: بدءًا من الإصدار 19.0.0، مكتبة برامج Google Ads API لنظام .NET لم تعد تدعم .NET 5.0. ولضمان التشغيل السلس، ننصحك بشدة ترقية إصدار .NET قبل نهاية 2024.

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

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

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

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

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

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

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

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

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

2. دوِّن Client ID وsecret ثم ارجع إلى هذه الصفحة.

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

1. في نافذة طرفية، شغِّل GenerateUserCredentials والذي يطالبك بمعرّف عميل OAuth2 وسره.

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

   dotnet run GenerateUserCredentials.csproj
   

2. يطالبك المثال بتقديم معرِّف عميل OAuth2 وsecret. أدخِل التفاصيل من الخطوة 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 بيانات الاعتماد في وقت التشغيل.