مكتبة برامج .NET
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتم استضافة مكتبة عملاء .NET على GitHub ويتم توزيعها على شكل حزمة NuGet. وتوفّر هذه المكتبة العديد من الميزات التي تساعدك في استخدام واجهة برمجة التطبيقات، بما في ذلك تسهيل إدارة بيانات الاعتماد وإنشاء برامج خدمة Google Ads API.
تتوافق المكتبة مع أُطر عمل .NET التالية:
- .NET Framework 4.7.2 والإصدارات الأحدث (
net472)
- .NET Standard 2.1 (
netstandard2.1)
- .NET 6.0 (
net6.0)
- .NET 8.0 (
net8.0)
يتوافق الإصدار 2.1 من.NET Standard مع العديد من إصدارات .NET وعمليات التنفيذ الأخرى، لذا قد يعمل البرنامج بشكل جيد على العديد من الأنظمة الأساسية الأخرى.
ومع ذلك، لم نختبر التوافق بشكل رسمي، وبالتالي لا نتيح هذه المنصات بشكل رسمي.
يمكنك الانتقال إلى https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-1
للحصول على مزيد من المعلومات حول التوافق مع معيار .NET.
تستخدم مكتبة Google Ads API لنظام NET .Grpc.Net.Client كإعداد تلقائي، مع
الرجوع إلى Grpc.Core على المنصات غير المتوافقة. يمكنك فرض استخدام
Grpc.Core من خلال ضبط UseGrpcCore على true. راجِع استخدام مكتبة Grpc القديمة.
لبدء استخدام هذه المكتبة، راجِع المتطلبات الأساسية واطّلِع على دليل البدء.
للحصول على معلومات حول رموز إعادة تحميل OAuth2 المميزة، يمكنك الاطّلاع على تدفّقات تطبيقات سطح المكتب والويب في OAuth. ولإجراء طلبات البيانات من واجهة برمجة التطبيقات باستخدام حسابات الخدمة OAuth2، يُرجى الاطّلاع على مسار حساب الخدمة OAuth.
راجِع الأدلة التالية للتعرّف على ميزات المكتبة وأدواتها:
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Ads API client library for .NET will no longer support .NET 5.0 starting with version 19.0.0, and users should upgrade to a supported version before the end of 2024.\u003c/p\u003e\n"],["\u003cp\u003eThe library supports .NET Framework 4.7.2+, .NET Standard 2.1, .NET 6.0, and .NET 8.0.\u003c/p\u003e\n"],["\u003cp\u003eIt is available as a NuGet package and hosted on GitHub, providing features for easier credential management and service client creation.\u003c/p\u003e\n"],["\u003cp\u003eWhile .NET Standard 2.1 offers compatibility with various .NET versions and implementations, only the explicitly listed frameworks are officially supported.\u003c/p\u003e\n"],["\u003cp\u003eUsers can find comprehensive documentation and guides, covering setup, OAuth flows, logging, and advanced features on the official Google Ads API website.\u003c/p\u003e\n"]]],[],null,["# The .NET Client Library\n\nThe .NET client library is [hosted on GitHub](https://github.com/googleads/google-ads-dotnet) and is distributed\nas a [NuGet package](//www.nuget.org/packages/Google.Ads.GoogleAds/). It\noffers several features to help you use the API, including easier management\nof credentials and creation of Google Ads API service clients.\n\nThe library supports the following .NET Frameworks:\n\n- .NET Framework 4.7.2+ (`net472`)\n- .NET Standard 2.1 (`netstandard2.1`)\n- .NET 6.0 (`net6.0`)\n- .NET 8.0 (`net8.0`)\n\n.NET Standard 2.1 is compatible with several other .NET versions and\nimplementations, so the library might work fine on many other platforms.\nHowever, we haven't officially tested the compatibility and thus don't\nofficially support these platforms.\nSee https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-1\nto learn more about .NET standard compatibility.\n\nThe Google Ads API .NET library uses `Grpc.Net.Client` as the default, with a\nfallback to `Grpc.Core` on unsupported platforms. You can force the use of\n`Grpc.Core` by setting `UseGrpcCore` to `true`. See\n[Use the legacy Grpc library](/google-ads/api/docs/client-libs/dotnet/getting-started).\n\nTo start using this library, check the\n[prerequisites](/google-ads/api/docs/get-started/introduction) and consult the\n[getting started guide](/google-ads/api/docs/client-libs/dotnet/getting-started).\n\nFor information on OAuth2 refresh tokens, check out [OAuth desktop and web\napplication flows](/google-ads/api/docs/client-libs/dotnet/oauth-web). And to make API calls\nusing OAuth2 service accounts, see [OAuth service account\nflow](/google-ads/api/docs/client-libs/dotnet/oauth-service).\n\nConsult the following guides for the library's features and utilities:\n\n- [Logging](/google-ads/api/docs/client-libs/dotnet/logging)\n- [FieldMasks](/google-ads/api/docs/client-libs/dotnet/field-masks)\n- [ResourceNames](/google-ads/api/docs/client-libs/dotnet/resource-names)\n- [Custom gRPC interceptors](/google-ads/api/docs/client-libs/dotnet/custom-interceptors)\n- [Protocol buffer types](/google-ads/api/docs/client-libs/dotnet/working-with-protobuf)"]]
