对 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+。