تدفقات 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. دوِّن معرِّف العميل والسرية، ثم ارجع إلى هذه الصفحة.

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