Unterstützung für gRPC

Bis Version 13.0.2 wurde in der Google Ads API-.NET-Bibliothek die Grpc.Core-Bibliothek für die gRPC-Funktionalität verwendet. Ab Version 14.0.0 der Clientbibliothek verwenden wir Grpc.Net.Client als Standardbibliothek für die gRPC-Funktionalität, mit Grpc.Core als Fallback. In diesem Leitfaden werden die technischen Details für diese Änderung behandelt.

Grund für den Wechsel

Grpc.Core ist für die Einstellung geplant und Grpc.Net.Client ist ab diesem Zeitpunkt die offizielle C#-Implementierung von gRPC. Hier finden Sie die Mitteilung.

Änderungen an der .NET-Bibliothek für die Google Ads API

Im Rahmen der Umstellung haben wir folgende Änderungen an unserer Clientbibliothek vorgenommen.

  1. Die neue GoogleAdsConfig-Einstellung „UseGrpcCore“ wurde eingeführt.

    • Die Standardeinstellung ist false.

    • Wenn diese Einstellung auf false gesetzt ist, versucht die Bibliothek nach Möglichkeit, Grpc.Net.Client als zugrunde liegende Verkehrsebene zu verwenden.

      Grpc.Net.Client unterstützt einige ältere .NET-Laufzeitversionen nicht (siehe Anforderungen). Auf diesen Plattformen verwendet die Google Ads API-.NET-Bibliothek stattdessen die Grpc.Core-Bibliothek als zugrunde liegende Transportebene.

    • Sie können erzwingen, dass die .NET-Bibliothek der Google Ads API immer verwendet wird, indem Sie UseGrpcCore auf true setzen.Grpc.Core

  2. Die .NET-Bibliothek der Google Ads API hängt vom Paket Google.Api.Gax.Grpc ab (Teil des Google Cloud SDK). Aufgrund der Änderung der gRPC-Bibliothek wurde die .NET Framework-Hauptversion in diesem Paket auf 4.0.0 und die Laufzeitanforderung auf .NET Standard 2.1 aktualisiert.

    Daher wurde die Laufzeitanforderung für die .NET-Bibliothek für die Google Ads API auf .NET Standard 2.1 aktualisiert. Die Google Ads API-Bibliothek unterstützt weiterhin .NET Framework 4.7.2 und höher sowie .NET 5.0 oder höher.