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 fallback. Questa guida illustra i dettagli tecnici relativi a questa modifica.

Motivo del passaggio

È previsto il ritiro di Grpc.Core e in futuro Grpc.Net.Client è l'implementazione C# ufficiale di gRPC. Leggi l'annuncio.

Modifiche alla libreria .NET dell'API Google Ads

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

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

    • Il valore predefinito di questa impostazione è false.

    • Se questa impostazione viene impostata su false, la libreria tenta di utilizzare Grpc.Net.Client come livello di trasporto sottostante, se 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 sottostante.

    • 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 il requisito 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 Google Ads continua a supportare .NET Framework 4.7.2 e versioni successive e .NET 5.0 e versioni successive.