Hỗ trợ gRPC

Đến phiên bản 13.0.2, thư viện API Google Ads .NET đã sử dụng thư viện Grpc.Core cho chức năng gRPC. Kể từ phiên bản 14.0.0 của thư viện ứng dụng, chúng tôi đang sử dụng Grpc.Net.Client làm thư viện mặc định cho chức năng gRPC, với Grpc.Core làm thư viện dự phòng. Hướng dẫn này trình bày thông tin kỹ thuật liên quan đến thay đổi này.

Lý do chuyển

Grpc.Core được lên lịch ngừng hoạt động và Grpc.Net.Client sẽ là phương thức triển khai C# chính thức của gRPC từ nay về sau. Đọc thông báo.

Những thay đổi đối với thư viện .NET của API Google Ads

Trong quá trình chuyển đổi này, chúng ta đã thực hiện các thay đổi sau đây đối với thư viện ứng dụng.

  1. Giới thiệu một chế độ cài đặt GoogleAdsConfig mới có tên là UseGrpcCore.

    • Chế độ cài đặt này mặc định là false.

    • Khi bạn đặt chế độ cài đặt này thành false, thư viện sẽ cố gắng sử dụng Grpc.Net.Client làm lớp phương tiện giao thông cơ bản (nếu có thể).

      Grpc.Net.Client không hỗ trợ một số phiên bản thời gian chạy .NET cũ (xem yêu cầu). Trên các nền tảng này, thư viện .NET của API Google Ads sẽ quay lại sử dụng thư viện Grpc.Core làm lớp phương tiện giao thông cơ bản.

    • Bạn có thể buộc thư viện .NET của API Google Ads luôn sử dụng thư viện Grpc.Core bằng cách đặt UseGrpcCore thành true.

  2. Thư viện .NET của API Google Ads phụ thuộc vào gói Google.Api.Gax.Grpc (một phần của Google Cloud SDK). Do thay đổi về thư viện gRPC, gói này đã cập nhật phiên bản chính của .NET Framework lên 4.0.0 và yêu cầu về thời gian chạy lên .NET Standard 2.1.

    Do đó, yêu cầu về thời gian chạy của thư viện API Google Ads .NET đã được cập nhật lên .NET Standard 2.1. Thư viện API Google Ads tiếp tục hỗ trợ .NET Framework 4.7.2 trở lên và .NET 5.0 trở lên.