Obsługa gRPC

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

Powód zmiany

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

Zmiany w bibliotece .NET interfejsu Google Ads API

W ramach przechodzenia z niej wprowadziliśmy w naszej bibliotece klienta podane niżej zmiany.

  1. Wprowadziliśmy nowe ustawienie w GoogleAdsConfig o nazwie UseGrpcCore.

    • Domyślna wartość tego ustawienia to false.

    • Gdy to ustawienie ma wartość false, w miarę możliwości biblioteka próbuje używać Grpc.Net.Client jako bazowej 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 użyje biblioteki Grpc.Core jako bazowej warstwy transportu.

    • Możesz wymusić używanie biblioteki .NET interfejsu Google Ads API przez cały czas, ustawiając w polu UseGrpcCore wartość true.Grpc.Core

  2. Biblioteka .NET interfejsu Google Ads API zależy od pakietu Google.Api.Gax.Grpc (część Google Cloud SDK). Ze względu na zmianę w bibliotece gRPC ten pakiet zaktualizował główną wersję .NET Framework do 4.0.0, a jego wymagania w zakresie środowiska wykonawczego zostały zaktualizowane do wersji .NET Standard 2.1.

    W związku z tym wymagania dotyczące środowiska wykonawczego biblioteki .NET interfejsu Google Ads API zostały zaktualizowane do wersji .NET Standard 2.1. Biblioteka interfejsów API Google Ads nadal obsługuje .NET Framework 4.7.2 i nowsze oraz .NET 5.0 i nowsze.