.NET 客户端库
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
.NET 客户端库托管在 GitHub 上,并以 NuGet 软件包的形式分发。它提供了多项功能来帮助您使用该 API,包括更轻松地管理凭据和创建 Google Ads API 服务客户端。
该库支持以下 .NET Framework:
- .NET Framework 4.7.2 及更高版本 (
net472
)
- .NET Standard 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
。您可以通过将 UseGrpcCore
设置为 true
来强制使用 Grpc.Core
。请参阅使用旧版 Grpc 库。
如需开始使用此库,请查看前提条件并参阅入门指南。
如需了解 OAuth2 刷新令牌,请参阅 OAuth 桌面应用和 Web 应用流程。如需了解如何使用 OAuth2 服务账号进行 API 调用,请参阅 OAuth 服务账号流程。
如需了解该库的功能和实用程序,请参阅以下指南:
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-26。
[null,null,["最后更新时间 (UTC):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)"]]