gRPC のサポート

警告: バージョン 19.0.0 以降、.NET 用 Google Ads API クライアント ライブラリで .NET 5.0 がサポートされなくなります。シームレスなオペレーションを実現するために、2024 年末までに .NET バージョンのバージョンをアップグレードすることを強くおすすめします。

v13.0.2 までは、Google Ads API .NET ライブラリは gRPC 機能に Grpc.Core ライブラリを使用していました。バージョン 14.0.0 のクライアント ライブラリでは、gRPC 機能のデフォルト ライブラリとして Grpc.Net.Client を使用し、フォールバックとして Grpc.Core を使用しています。このガイドでは、この変更に関連する技術的な詳細について説明します。

切り替えの理由

Grpc.Core は廃止される予定です。今後、gRPC の正式な C# 実装は Grpc.Net.Client になります。お知らせをご覧ください。

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