Supporto per gRPC

Fino alla versione 13.0.2, la libreria .NET dell'API Google Ads utilizzava la libreria Grpc.Core per la funzionalità gRPC. A partire dalla versione 14.0.0 della libreria client, utilizziamo Grpc.Net.Client come libreria predefinita per la funzionalità gRPC, con Grpc.Core come riserva. Questa guida illustra i dettagli tecnici relativi a questa modifica.

Motivo del passaggio

Il ritiro di Grpc.Core è programmato e Grpc.Net.Client sarà l'implementazione C# ufficiale di gRPC in futuro. Leggi l'annuncio.

Modifiche alla libreria .NET dell'API Google Ads

Nell'ambito del passaggio, abbiamo apportato le seguenti modifiche alla nostra libreria client.

  1. È stata introdotta una nuova impostazione GoogleAdsConfig denominata UseGrpcCore.

    • Il valore predefinito di questa impostazione è false.

    • Se questa impostazione è impostata su false, la libreria tenta di utilizzare Grpc.Net.Client come livello di trasporto sottostante, quando possibile.

      Grpc.Net.Client non supporta alcune versioni precedenti del runtime .NET (vedi i requisiti). Su queste piattaforme, la libreria .NET dell'API Google Ads utilizzerà la libreria Grpc.Core come livello di trasporto di base.

    • Puoi forzare la libreria .NET dell'API Google Ads a utilizzare sempre la libreria Grpc.Core impostando UseGrpcCore su true.

  2. La libreria .NET dell'API Google Ads dipende dal pacchetto Google.Api.Gax.Grpc (parte di Google Cloud SDK). A causa della modifica alla libreria gRPC, questo pacchetto ha aggiornato la versione principale di .NET Framework alla 4.0.0 e i requisiti di runtime a .NET Standard 2.1.

    Di conseguenza, il requisito di runtime della libreria .NET dell'API Google Ads è stato aggiornato a .NET Standard 2.1. La libreria API di Google Ads continua a supportare .NET Framework 4.7.2 e versioni successive e .NET 5.0 e versioni successive.