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

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

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

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

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

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

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

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

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

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

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

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

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

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

    dotnet run GenerateUserCredentials.csproj

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