Compatibilité avec gRPC

Jusqu'à la version 13.0.2, la bibliothèque .NET de l'API Google Ads utilisait la bibliothèque Grpc.Core pour la fonctionnalité gRPC. À partir de la version 14.0.0 de la bibliothèque cliente, nous utilisons Grpc.Net.Client comme bibliothèque par défaut pour la fonctionnalité gRPC, avec Grpc.Core comme solution de secours. Ce guide décrit les détails techniques liés à ce changement.

Pourquoi passer au Pixel ?

L'arrêt de Grpc.Core est programmé, et Grpc.Net.Client est l'implémentation C# officielle de gRPC à l'avenir. Lire l'annonce

Modifications apportées à la bibliothèque .NET de l'API Google Ads

Dans le cadre de cette transition, nous avons apporté les modifications suivantes à notre bibliothèque cliente.

1. Introduction d'un paramètre GoogleAdsConfig nommé UseGrpcCore.

   • Ce paramètre est défini par défaut sur false.

   • Lorsque ce paramètre est défini sur false, la bibliothèque tente d'utiliser Grpc.Net.Client comme couche de transport sous-jacente lorsque cela est possible.

     Grpc.Net.Client n'est pas compatible avec certaines versions d'exécution .NET plus anciennes (consultez la configuration requise). Sur ces plates-formes, la bibliothèque .NET de l'API Google Ads utilisera la bibliothèque Grpc.Core comme couche de transport sous-jacente.

   • Vous pouvez forcer la bibliothèque .NET de l'API Google Ads à utiliser la bibliothèque Grpc.Core tout le temps en définissant UseGrpcCore sur true.

2. La bibliothèque .NET de l'API Google Ads dépend du package Google.Api.Gax.Grpc (qui fait partie du SDK Google Cloud). En raison de la modification de la bibliothèque gRPC, ce package a mis à jour sa version majeure de .NET Framework vers la version 4.0.0 et ses exigences d'exécution vers .NET Standard 2.1.

   Par conséquent, les exigences d'exécution de la bibliothèque .NET de l'API Google Ads ont été mises à jour vers .NET Standard 2.1. La bibliothèque de l'API Google Ads reste compatible avec .NET Framework 4.7.2 et versions ultérieures, et .NET 5.0 et versions ultérieures.