การรองรับ gRPC

ไลบรารี .NET ของ Google Ads API จนถึง v13.0.2 ใช้ไลบรารี Grpc.Core สำหรับฟังก์ชัน gRPC ตั้งแต่เวอร์ชัน 14.0.0 ของไลบรารีของไคลเอ็นต์ เรากําลังใช้ Grpc.Net.Client เป็นไลบรารีเริ่มต้นสำหรับฟังก์ชัน gRPC โดยมี Grpc.Core เป็นไลบรารีสำรอง คู่มือนี้มีรายละเอียดทางเทคนิคที่เกี่ยวข้องกับการเปลี่ยนแปลงนี้

เหตุผลในการเปลี่ยน

Grpc.Core มีกำหนดหยุดให้บริการ และ Grpc.Net.Client จะเป็นการติดตั้งใช้งาน C# อย่างเป็นทางการของ gRPC นับจากนี้เป็นต้นไป อ่านประกาศ

การเปลี่ยนแปลงไลบรารี .NET ของ Google Ads API

ในการเปลี่ยนแปลงครั้งนี้ เราได้ทำการเปลี่ยนแปลงต่อไปนี้กับไลบรารีของไคลเอ็นต์

  1. เปิดตัวการตั้งค่าใหม่ชื่อ UseGrpcCore ใน GoogleAdsConfig

    • การตั้งค่านี้มีค่าเริ่มต้นเป็น false

    • เมื่อกำหนดการตั้งค่านี้เป็น false ไลบรารีจะพยายามใช้ Grpc.Net.Client เป็นเลเยอร์การขนส่งที่สำคัญเมื่อเป็นไปได้

      Grpc.Net.Client ไม่รองรับรันไทม์ .NET เวอร์ชันเก่าบางเวอร์ชัน (ดูข้อกำหนด) ในแพลตฟอร์มเหล่านี้ ไลบรารี .NET ของ Google Ads API จะกลับไปใช้ไลบรารี Grpc.Core เป็นเลเยอร์การขนส่งที่สำคัญ

    • คุณบังคับให้ไลบรารี .NET ของ Google Ads API ใช้ไลบรารี Grpc.Core ตลอดเวลาได้โดยการตั้งค่า UseGrpcCore เป็น true

  2. ไลบรารี .NET ของ Google Ads API ขึ้นอยู่กับแพ็กเกจ Google.Api.Gax.Grpc (ส่วนหนึ่งของ Google Cloud SDK) เนื่องจากการเปลี่ยนแปลงไลบรารี gRPC แพ็กเกจนี้ได้อัปเดตเวอร์ชันหลักของ .NET Framework เป็น 4.0.0 และข้อกำหนดรันไทม์เป็น .NET Standard 2.1

    ด้วยเหตุนี้ ข้อกำหนดรันไทม์ของไลบรารี .NET ของ Google Ads API จึงได้รับการอัปเดตเป็น .NET Standard 2.1 ไลบรารีของ Google Ads API ยังคงรองรับ .NET Framework 4.7.2 ขึ้นไป และ .NET 5.0 ขึ้นไป