Compatibilidad con gRPC

Hasta la versión 13.0.2, la biblioteca .NET de la API de Google Ads usó la biblioteca Grpc.Core para la funcionalidad de gRPC. A partir de la versión 14.0.0 de la biblioteca cliente, usamos Grpc.Net.Client como la biblioteca predeterminada para la funcionalidad de gRPC, con Grpc.Core como resguardo. En esta guía, se abordan los detalles técnicos relacionados con este cambio.

Motivo del cambio

Grpc.Core está programado para el retiro, y Grpc.Net.Client es la implementación oficial de C# de gRPC en el futuro. Lee el anuncio.

Cambios en la biblioteca .NET de la API de Google Ads

Como parte de este proceso, realizamos los siguientes cambios en nuestra biblioteca cliente.

  1. Se agregó un nuevo parámetro de configuración de GoogleAdsConfig llamado UseGrpcCore.

    • El valor predeterminado de esta configuración es false.

    • Cuando se establece esta configuración en false, la biblioteca intenta usar Grpc.Net.Client como capa de transporte subyacente cuando sea posible.

      Grpc.Net.Client no admite algunas versiones anteriores del entorno de ejecución de .NET (consulta los requisitos). En estas plataformas, la biblioteca .NET de la API de Google Ads recurrirá al uso de la biblioteca Grpc.Core como capa de transporte subyacente.

    • Puedes hacer que la biblioteca .NET de la API de Google Ads use la biblioteca Grpc.Core todo el tiempo si configuras UseGrpcCore como true.

  2. La biblioteca .NET de la API de Google Ads depende del paquete Google.Api.Gax.Grpc (parte del SDK de Google Cloud). Debido al cambio de la biblioteca de gRPC, este paquete actualizó su versión principal de .NET Framework a 4.0.0 y su requisito de entorno de ejecución a .NET Standard 2.1.

    Como resultado, el requisito del entorno de ejecución de la biblioteca .NET de la API de Google Ads se actualizó a .NET Standard 2.1. La biblioteca de la API de Google Ads sigue siendo compatible con .NET Framework 4.7.2 (o versiones posteriores) y .NET 5.0 (o versiones posteriores).