支援 gRPC

在 13.0.2 版之前,Google Ads API .NET 程式庫使用 Grpc.Core 程式庫執行 gRPC 功能。自用戶端程式庫 14.0.0 版起,我們使用 Grpc.Net.Client 做為 gRPC 功能的預設程式庫,並以 Grpc.Core 做為備用方案。本指南將說明這項變更的相關技術細節。

改用 Pixel 的原因

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 標準 2.1。

    因此,Google Ads API .NET 程式庫執行階段要求已更新為 .NET Standard 2.1。Google Ads API 程式庫將持續支援 .NET Framework 4.7.2+ 和 .NET 5.0 以上版本。