การรองรับ gRPC

ไลบรารี .NET ของ Google Ads API เวอร์ชันไม่เกิน 13.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. แนะนำการตั้งค่า GoogleAdsConfig ใหม่ที่ชื่อว่า UseGrpcCore

   • ค่าเริ่มต้นของการตั้งค่านี้คือ 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 ขึ้นไป