Поддержка gRPC

До версии 13.0.2 библиотека Google Ads API .NET использовала библиотеку Grpc.Core для функциональности gRPC. Начиная с версии 14.0.0 клиентской библиотеки, мы используем Grpc.Net.Client в качестве библиотеки по умолчанию для функций gRPC, а Grpc.Core — в качестве резервной. В этом руководстве описаны технические подробности, связанные с этим изменением.

Причина переключения

Grpc.Core запланировано на будущее, а Grpc.Net.Client — это официальная реализация gRPC на C#. Прочтите объявление .

Изменения в библиотеке Google Ads API .NET.

В рамках перехода мы внесли следующие изменения в нашу клиентскую библиотеку.

  1. Представлен новый параметр GoogleAdsConfig с именем UseGrpcCore .

    • По умолчанию этот параметр имеет значение false .

    • Если для этого параметра установлено значение false , библиотека пытается использовать Grpc.Net.Client в качестве базового транспортного уровня, когда это возможно.

      Grpc.Net.Client не поддерживает некоторые старые версии среды выполнения .NET (см. требования ). На этих платформах библиотека Google Ads API .NET будет использовать библиотеку Grpc.Core в качестве базового транспортного уровня.

    • Вы можете заставить библиотеку Google Ads API .NET постоянно использовать библиотеку Grpc.Core , задав для UseGrpcCore значение true .

  2. Библиотека Google Ads API .NET зависит от пакета Google.Api.Gax.Grpc (часть Google Cloud SDK). В связи с изменением библиотеки gRPC в этом пакете основная версия .NET Framework обновлена ​​до 4.0.0, а требования к среде выполнения — до .NET Standard 2.1.

    В результате требования к среде выполнения библиотеки .NET API Google Рекламы были обновлены до .NET Standard 2.1. Библиотека API Google Рекламы продолжает поддерживать .NET Framework 4.7.2+ и .NET 5.0+.