Suporte para gRPC

Até a versão 13.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, estamos usando Grpc.Net.Client como a biblioteca padrão para a funcionalidade do gRPC, com Grpc.Core como substituto. Neste guia, abordamos 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 é a implementação oficial do gRPC em C# daqui em diante. Leia o anúncio.

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

Como parte dessa mudança, fizemos as seguintes alterações na 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 quando possível.

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

    • Você pode forçar a biblioteca .NET da API Google Ads a usar a biblioteca Grpc.Core o tempo todo, definindo UseGrpcCore como true.

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

    Como resultado, o requisito de ambiente de execução da biblioteca .NET da API Google Ads foi atualizado para o .NET Standard 2.1. A biblioteca da Google Ads API continua compatível com .NET Framework 4.7.2 ou posterior e .NET 5.0 ou posterior.