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 ライブラリにフォールバックします。

    • UseGrpcCoretrue に設定すると、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 以降を引き続きサポートしています。