Unterstützung für gRPC

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

Grund für den Wechsel

Grpc.Core wird eingestellt und Grpc.Net.Client ist die offizielle C#-Implementierung von gRPC. Ankündigung lesen

Änderungen an der Google Ads API-.NET-Bibliothek

Im Rahmen der Umstellung haben wir die folgenden Änderungen an unserer Client-Bibliothek vorgenommen.

  1. Es wurde eine neue GoogleAdsConfig-Einstellung namens „UseGrpcCore“ eingeführt.

    • Die Standardeinstellung für diese Einstellung 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 .NET-Bibliothek der Google Ads API die Grpc.Core-Bibliothek als zugrunde liegende Transportebene.

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

  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 Hauptversion dieses Pakets von .NET Framework auf 4.0.0 und die Laufzeitanforderung auf .NET Standard 2.1 aktualisiert.

    Aus diesem Grund wurde die Laufzeitanforderung der .NET-Bibliothek für die Google Ads API auf den .NET-Standard 2.1 aktualisiert. Die Google Ads API-Bibliothek unterstützt weiterhin .NET Framework 4.7.2+ und .NET 5.0+.