gRPC 지원

v13.0.2까지 Google Ads API .NET 라이브러리는 gRPC 기능에 Grpc.Core 라이브러리를 사용했습니다. 클라이언트 라이브러리 버전 14.0.0부터는 Grpc.Net.Client를 gRPC 기능의 기본 라이브러리로 사용하고 Grpc.Core를 대체 라이브러리로 사용합니다. 이 가이드에서는 이 변경사항과 관련된 기술 세부정보를 다룹니다.

전환 이유

Grpc.Core의 지원이 종료될 예정이며 향후 gRPC의 공식 C# 구현은 Grpc.Net.Client입니다. 공지 확인하기

Google Ads API .NET 라이브러리 변경사항

전환 과정에서 클라이언트 라이브러리가 다음과 같이 변경되었습니다.

  1. UseGrpcCore라는 새로운 GoogleAdsConfig 설정을 도입했습니다.

    • 이 설정의 기본값은 false입니다.
    • 이 설정을 false로 설정하면 라이브러리는 가능한 경우 Grpc.Net.Client를 기본 교통 계층으로 사용하려고 합니다.

      Grpc.Net.Client는 일부 이전 .NET 런타임 버전을 지원하지 않습니다 (요구사항 참고). 이러한 플랫폼에서는 Google Ads API .NET 라이브러리가 Grpc.Core 라이브러리를 기본 교통 레이어로 사용하는 방식으로 대체됩니다.

    • UseGrpcCoretrue로 설정하여 Google Ads API .NET 라이브러리에서 항상 Grpc.Core 라이브러리를 사용하도록 강제할 수 있습니다.

  2. Google Ads API .NET 라이브러리는 Google Cloud SDK의 일부인 Google.Api.Gax.Grpc 패키지에 종속됩니다. gRPC 라이브러리 변경으로 인해 이 패키지는 .NET Framework 주 버전을 4.0.0으로, 런타임 요구사항은 .NET Standard 2.1로 업데이트했습니다.

    이에 따라 Google Ads API .NET 라이브러리 런타임 요구사항이 .NET Standard 2.1로 업데이트되었습니다. Google Ads API 라이브러리는 .NET Framework 4.7.2 이상과 .NET 5.0 이상을 계속 지원합니다.