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

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

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

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

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

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

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

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

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

ابدأ GoogleAdsClient باستخدام إعدادات الضبط واسترداد عميل خدمة لإجراء طلبات البيانات من واجهة برمجة التطبيقات:

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

راجِع دليل الاستخدام الأساسي لمعرفة المزيد حول كيفية استخدام مكتبة برامج ‎.NET.

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

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

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

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

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

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

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

راجِع دليل تحسين الأداء للحصول على اقتراحات حول كيفية تحسين أداء تطبيقك.