Compatibilidad con gRPC

Hasta la versión 13.0.2, la biblioteca .NET de la API de Google Ads usaba 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 descontinuarse, y Grpc.Net.Client es la implementación oficial de gRPC en C# de ahora en adelante. Lee el anuncio.

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

Como parte del cambio, realizamos los siguientes cambios en nuestra biblioteca cliente.

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

   • La configuración predeterminada es false.

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

     Grpc.Net.Client no es compatible con 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á a 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 en la biblioteca de gRPC, este paquete actualizó su versión principal de .NET Framework a la versión 4.0.0 y su requisito de entorno de ejecución a .NET Standard 2.1.

   Como resultado, el requisito de entorno de ejecución de la biblioteca .NET de la API de Google Ads se actualizó al estándar 2.1 de.NET. La biblioteca de la API de Google Ads sigue siendo compatible con .NET Framework 4.7.2 y versiones posteriores, y .NET 5.0 y versiones posteriores.