对 gRPC 的支持

在 v13.0.2 及之前的版本中,Google Ads API .NET 库使用 Grpc.Core 库来实现 gRPC 功能。从客户端库 14.0.0 版开始,我们使用 Grpc.Net.Client 作为 gRPC 功能的默认库,使用 Grpc.Core 作为后备。本指南介绍了与此变更相关的技术详情。

切换原因

Grpc.Core 已计划停用,而 Grpc.Net.Client 将是 gRPC 今后的官方 C# 实现。阅读公告

Google Ads API .NET 库的更改

在转换过程中,我们对客户端库进行了以下更改。

  1. 引入了名为 UseGrpcCore 的新 GoogleAdsConfig 设置。

    • 此设置默认为 false
    • 当此设置设为 false 时,该库会尽可能尝试将 Grpc.Net.Client 用作底层交通图层。

      Grpc.Net.Client 不支持某些较低的 .NET 运行时版本(请参阅要求)。在这些平台上,Google Ads API .NET 库将回退到使用 Grpc.Core 库作为底层传输层。

    • 您可以通过将 UseGrpcCore 设置为 true,强制 Google Ads API .NET 库始终使用 Grpc.Core 库。

  2. Google Ads API .NET 库依赖于 Google.Api.Gax.Grpc 软件包(Google Cloud SDK 的一部分)。由于 gRPC 库发生更改,此软件包已将其 .NET Framework 主要版本更新为 4.0.0,并将其运行时要求更新为 .NET Standard 2.1。

    因此,Google Ads API .NET 库运行时要求已更新为 .NET Standard 2.1。Google Ads API 库继续支持 .NET Framework 4.7.2+ 和 .NET 5.0+。