Hỗ trợ gRPC

Phiên bản 13.0.2 trở lên, thư viện Google Ads API .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 sẽ sử dụng Grpc.Net.Client làm thư viện mặc định cho chức năng gRPC, trong đó Grpc.Core làm thư viện dự phòng. Hướng dẫn này đề cập đến các thông tin kỹ thuật liên quan đến thay đổi này.

Lý do chuyển đổi

Grpc.Core được lên lịch ngừng cung cấp 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.

Các 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 tôi đã thực hiện các thay đổi sau đây đối với thư viện ứng dụng.

  1. Ra 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 truyền tải cơ bản khi có thể.

      Grpc.Net.Client không hỗ trợ một số phiên bản thời gian chạy .NET cũ (xem các 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 truyền tải cơ bản.

    • Bạn có thể buộc thư viện API .NET của Google Ads sử dụng thư viện Grpc.Core luôn 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 .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 thư viện .NET của API Google Ads đã đượ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.