gRPC のサポート

v13.0.2 までは、Google Ads API .NET ライブラリでは gRPC 機能に Grpc.Core ライブラリが使用されていました。クライアント ライブラリのバージョン 14.0.0 では、gRPC 機能のデフォルト ライブラリとして Grpc.Net.Client を使用し、フォールバックとして 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 ライブラリを基盤となるトランスポート レイヤとして使用します。

    • Google Ads API .NET ライブラリが Grpc.Core ライブラリを常に使用するようにするには、UseGrpcCoretrue に設定します。

  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 以降を引き続きサポートしています。