Obsługa gRPC

Do wersji 13.0.2 biblioteka .NET interfejsu Google Ads API korzystała z biblioteki Grpc.Core na potrzeby funkcji gRPC. Od wersji 14.0.0 biblioteki klienta używamy Grpc.Net.Client jako biblioteki domyślnej funkcji gRPC, a bibliotekę zastępczą Grpc.Core. W tym przewodniku omawiamy szczegóły techniczne związane z tą zmianą.

Powód zmiany

Zaplanowano wycofanie Grpc.Core, a Grpc.Net.Client to od tej pory oficjalna implementacja gRPC w C#. Przeczytaj ogłoszenie

Zmiany w bibliotece .NET interfejsu Google Ads API

W związku z przejściem wprowadziliśmy te zmiany w bibliotece klientów.

  1. Wprowadzono nowe ustawienie GoogleAdsConfig o nazwie UseGrpcCore.

    • Domyślna wartość to false.

    • Gdy to ustawienie ma wartość false, biblioteka w miarę możliwości próbuje użyć Grpc.Net.Client jako podstawowej warstwy transportu.

      Grpc.Net.Client nie obsługuje niektórych starszych wersji środowiska wykonawczego .NET (zobacz wymagania). Na tych platformach biblioteka .NET interfejsu Google Ads API będzie używać biblioteki Grpc.Core jako podstawowej warstwy transportu.

    • Możesz wymusić ciągłe używanie biblioteki Grpc.Core interfejsu Google Ads API, ustawiając UseGrpcCore na true.

  2. Biblioteka .NET interfejsu Google Ads API korzysta z pakietu Google.Api.Gax.Grpc (część pakietu SDK Google Cloud). Z powodu zmiany biblioteki gRPC ten pakiet zmienił wersję główną .NET Framework do 4.0.0, a jego wymagania w środowisku wykonawczym do wersji .NET Standard 2.1.

    W związku z tym zmieniliśmy wymagania dotyczące środowiska wykonawczego .NET API Google Ads do wersji .NET Standard 2.1. Biblioteka interfejsu Google Ads API nadal obsługuje .NET Framework 4.7.2+ i .NET 5.0+.