支援 gRPC

Google Ads API .NET 程式庫 13.0.2 版以下,使用 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 Standard 2.1。

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