Клиентская библиотека .NET
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Клиентская библиотека .NET размещена на GitHub и распространяется в виде пакета NuGet . Она предлагает ряд функций, упрощающих использование API, включая более удобное управление учётными данными и создание клиентов API сервиса Google Ads.
Библиотека поддерживает следующие .NET Frameworks:
- .NET Framework 4.7.2+ (
net472 ) - .NET Стандарт 2.1 (
netstandard2.1 ) - .NET 6.0 (
net6.0 ) - .NET 8.0 (
net8.0 )
.NET Standard 2.1 совместим с несколькими другими версиями и реализациями .NET, поэтому библиотека может без проблем работать на многих других платформах. Однако мы официально не тестировали совместимость и поэтому официально не поддерживаем эти платформы. Подробнее о совместимости со стандартом .NET см. на странице https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-1.
Библиотека Google Ads API .NET использует Grpc.Net.Client по умолчанию, а на неподдерживаемых платформах можно использовать Grpc.Core . Вы можете принудительно использовать Grpc.Core , установив UseGrpcCore в true . См. раздел Использование устаревшей библиотеки Grpc .
Чтобы начать использовать эту библиотеку, проверьте предварительные требования и ознакомьтесь с руководством по началу работы .
Информацию о токенах обновления OAuth2 см. в разделе «Процессы работы OAuth в настольных и веб-приложениях» . Чтобы выполнять вызовы API с использованием учётных записей служб OAuth2, см. раздел «Процесс работы учётной записи служб OAuth» .
Информацию о функциях и утилитах библиотеки см. в следующих руководствах:
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-26 UTC.
[null,null,["Последнее обновление: 2025-08-26 UTC."],[[["\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)"]]
