Obsługa gRPC

Do wersji 13.0.2 biblioteka .NET interfejsu Google Ads API używała biblioteki Grpc.Core na potrzeby funkcji gRPC. W wersji 14.0.0 biblioteki klienta domyślną biblioteką funkcji gRPC jest Grpc.Net.Client, a wartością zastępczą Grpc.Core. W tym przewodniku znajdziesz szczegóły techniczne związane z tą zmianą.

Przyczyna zmiany

Zaplanowano wycofanie Grpc.Core, a Grpc.Net.Client to oficjalna implementacja gRPC w języku C#. Przeczytaj ogłoszenie

Zmiany w bibliotece .NET interfejsu Google Ads API

W ramach przełączania się wprowadziliśmy w naszej bibliotece klientów opisane poniżej zmiany.

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

   • Domyślne ustawienie to false.

   • Gdy to ustawienie ma wartość false, biblioteka próbuje w miarę możliwości 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 opcję UseGrpcCore na true.Grpc.Core

2. Biblioteka .NET interfejsu Google Ads API zależy od pakietu Google.Api.Gax.Grpc (część pakietu Google Cloud SDK). Z powodu zmiany biblioteki gRPC pakiet został zaktualizowany do wersji głównej .NET Framework do wersji 4.0.0, a wymagania jego środowiska wykonawczego 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 interfejsu Google Ads API nadal obsługuje .NET Framework 4.7.2 i nowsze oraz .NET 5.0 i nowsze.