Suporte para gRPC

Até v13.0.2, a biblioteca .NET da API Google Ads usava a biblioteca Grpc.Core para a funcionalidade gRPC. A partir da versão 14.0.0 da biblioteca de cliente, usamos Grpc.Net.Client como a biblioteca padrão para a funcionalidade do gRPC, com Grpc.Core como substituto. Este guia aborda os detalhes técnicos relacionados a essa mudança.

Motivo da mudança

A desativação de Grpc.Core está programada, e Grpc.Net.Client será a implementação oficial em C# do gRPC a partir de agora. Leia o anúncio.

Alterações na biblioteca .NET da API Google Ads

Como parte da mudança, fizemos as seguintes alterações em nossa biblioteca de cliente.

1. Introdução de uma nova configuração GoogleAdsConfig chamada UseGrpcCore.

   • O padrão dessa configuração é false.

   • Quando essa configuração é definida como false, a biblioteca tenta usar Grpc.Net.Client como a camada de transporte subjacente sempre que possível.

     Grpc.Net.Client não é compatível com algumas versões mais antigas do ambiente de execução do .NET. Consulte os requisitos. Nessas plataformas, a biblioteca .NET da API Google Ads voltará a usar a biblioteca Grpc.Core como a camada de transporte subjacente.

   • É possível forçar a biblioteca .NET da API Google Ads a usar a biblioteca Grpc.Core o tempo todo. Para isso, defina UseGrpcCore como true.

2. A biblioteca .NET da API Google Ads depende do pacote Google.Api.Gax.Grpc (parte do SDK do Google Cloud). Devido à alteração na biblioteca gRPC, este pacote atualizou a versão principal do .NET Framework para 4.0.0 e o requisito de ambiente de execução para o .NET Standard 2.1.

   Como resultado, o requisito de tempo de execução da biblioteca .NET da API Google Ads foi atualizado para a versão padrão 2.1. A biblioteca da Google Ads API continua compatível com o .NET Framework 4.7.2 ou mais recente e o .NET 5.0 ou mais recente.