مكتبة برامج ‎ .NET

تتم استضافة مكتبة عملاء ‎ .NET على GitHub ويتم توزيعها كـ حزمة NuGet. وتوفّر هذه المكتبة العديد من الميزات لمساعدتك في استخدام واجهة برمجة التطبيقات، بما في ذلك تسهيل إدارة بيانات الاعتماد وإنشاء عملاء خدمة Google Ads API.

تتوافق المكتبة مع إطارات عمل ‎ .NET التالية:

  • الإصدار 4.7.2 من ‎.NET Framework والإصدارات الأحدث (net472)
  • ‫‎.NET Standard 2.1‏ (netstandard2.1)
  • ‫‎.NET 8.0 (net8.0)

يتوافق ‎.NET Standard 2.1 مع العديد من إصدارات ‎ .NET الأخرى وعمليات التنفيذ، لذا قد تعمل المكتبة بشكل جيد على العديد من الأنظمة الأساسية الأخرى. ومع ذلك، لم نختبر التوافق رسميًا، وبالتالي لا نتيح هذه المنصات رسميًا. لمزيد من المعلومات، يمكنك الاطّلاع على مستندات ‎.NET Standard 2.1.

تستخدم مكتبة ‎ .NET في Google Ads API بروتوكول Grpc.Net.Client كطبقة نقل تلقائية، مع الرجوع إلى Grpc.Core على الأنظمة الأساسية غير المتوافقة. يمكنك فرض استخدام Grpc.Core من خلال ضبط UseGrpcCore على true، ولكن يُرجى العِلم أنّ Grpc.Core متوقّف نهائيًا ومخصّص فقط للصيانة القديمة. لمزيد من المعلومات، يُرجى الاطّلاع على دليل الاستخدام الأساسي.

تثبيت

ثبِّت حزمة NuGet‏ Google.Ads.GoogleAds في مشروعك باستخدام أداة سطر الأوامر dotnet:

dotnet add package Google.Ads.GoogleAds

لتحميل إعدادات الضبط من appsettings.json أو App.config أو متغيّرات البيئة، عليك أيضًا تثبيت حزمة Google.Ads.GoogleAds.Extensions:

dotnet add package Google.Ads.GoogleAds.Extensions

إجراء أول طلب بيانات من واجهة برمجة التطبيقات

لاستخدام Google Ads API، عليك تنفيذ عدة خطوات للوصول إلى واجهة برمجة التطبيقات وضبط حساباتك على "إعلانات Google". اتّبِع دليل البدء السريع الذي يوضّح لك جميع الخطوات المهمة، بما في ذلك إعداد حساباتك على "إعلانات Google".

الاستخدام الأساسي

ابدأ GoogleAdsConfig وGoogleAdsClient باستخدام إعدادات الضبط، واسترجع GoogleAdsServiceClient، وبث صفوف الحملة باستخدام SearchStream:

using System;
using Google.Ads.Gax.Config;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V26.Errors;
using Google.Ads.GoogleAds.V26.Services;

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_CLIENT_ID.apps.googleusercontent.com",
    OAuth2ClientSecret = "INSERT_CLIENT_SECRET",
    OAuth2RefreshToken = "INSERT_REFRESH_TOKEN",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};

GoogleAdsClient client = new GoogleAdsClient(config);
GoogleAdsServiceClient googleAdsService =
    client.GetService(Services.V26.GoogleAdsService);

string customerId = "INSERT_CUSTOMER_ID_HERE";
string query =
    "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";

try
{
    googleAdsService.SearchStream(
        customerId,
        query,
        delegate (SearchGoogleAdsStreamResponse response)
        {
            foreach (GoogleAdsRow row in response.Results)
            {
                Console.WriteLine(
                    $"Campaign ID {row.Campaign.Id}: {row.Campaign.Name}");
            }
        });
}
catch (GoogleAdsException ex)
{
    Console.WriteLine($"Request ID {ex.RequestId} failed: {ex.Message}");
}

يُرجى الرجوع إلى دليل الاستخدام الأساسي لمعرفة المزيد عن كيفية استخدام مكتبة برامج ‎.NET.

التفويض والمصادقة

تتيح مكتبة عملاء ‎ .NET استخدام طرق متعددة للمصادقة والتفويض، بما في ذلك بيانات اعتماد مستخدم OAuth 2.0 (لتطبيقات الويب وأجهزة الكمبيوتر المكتبي) وحسابات الخدمة وبيانات الاعتماد التلقائية للتطبيق (الإصدار v24.1.0 والإصدارات الأحدث) وإدخال بيانات الاعتماد يدويًا (الإصدار v27.0.0 والإصدارات الأحدث). لمزيد من المعلومات، يُرجى الرجوع إلى دليل التفويض والمصادقة.

الإعداد والتسجيل

تتيح مكتبة برامج ‎ .NET استخدام خيارات متعددة للإعداد والتسجيل باستخدام عناصر وقت التشغيل أو appsettings.json أو ملفات JSON المخصّصة أو متغيّرات البيئة أو ملفات App.config. إذا كنت بحاجة إلى تعديل سلوك التسجيل في مكتبة البرامج، يُرجى الرجوع إلى دليل اعتراض gRPC المخصّص.

الأدوات المساعدة

تتضمّن مكتبة برامج ‎ .NET فئات خدمات لتحسين سهولة استخدام واجهة برمجة التطبيقات، بما في ذلك أدوات مساعدة لتحميل الوسائط والفيديوهات (UploadVideo في v27.2.0 والإصدارات الأحدث). يُرجى الرجوع إلى الأدلة التالية لمزيد من المعلومات:

تحسين أداء تطبيقك

يُرجى الرجوع إلى دليل ضبط الأداء للحصول على اقتراحات حول كيفية ضبط أداء تطبيقك بدقة.