ไลบรารีของไคลเอ็นต์ .NET

ไลบรารีของไคลเอ็นต์ .NET โฮสต์อยู่ใน GitHub และเผยแพร่ เป็น แพ็กเกจ NuGet โดยมีฟีเจอร์มากมายที่จะช่วยให้คุณใช้ API ได้ง่ายขึ้น เช่น การจัดการข้อมูลเข้าสู่ระบบและการสร้างไคลเอ็นต์บริการ Google Ads API ได้ง่ายขึ้น

ไลบรารีรองรับเฟรมเวิร์ก .NET ต่อไปนี้

  • .NET Framework 4.7.2 ขึ้นไป (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

.NET Standard 2.1 เข้ากันได้กับ .NET เวอร์ชันและการติดตั้งใช้งานอื่นๆ อีกหลายรายการ ดังนั้นไลบรารีจึงอาจทำงานได้ดีในแพลตฟอร์มอื่นๆ อีกมากมาย อย่างไรก็ตาม เรายังไม่ได้ทดสอบความเข้ากันได้อย่างเป็นทางการ จึงไม่รองรับแพลตฟอร์มเหล่านี้อย่างเป็นทางการ ดูข้อมูลเพิ่มเติมได้ใน เอกสารประกอบ .NET Standard 2.1

ไลบรารี Google Ads API .NET ใช้ Grpc.Net.Client เป็นเลเยอร์การรับส่งข้อมูลเริ่มต้น โดยจะใช้ Grpc.Core เป็นตัวเลือกสำรองในแพลตฟอร์มที่ไม่รองรับ แม้ว่าคุณจะบังคับให้ใช้ Grpc.Core ได้โดยตั้งค่า UseGrpcCore เป็น true แต่โปรดทราบว่า Grpc.Core เลิกใช้งานแล้วและมีไว้สำหรับการบำรุงรักษาเวอร์ชันเก่าเท่านั้น ดูข้อมูลเพิ่มเติมได้ใน คู่มือการใช้งานพื้นฐาน

ทำการเรียก API ครั้งแรก

หากต้องการใช้ Google Ads API คุณต้องทำตามขั้นตอนต่างๆ เพื่อรับสิทธิ์เข้าถึง API และกำหนดค่าบัญชี Google Ads โปรดทำตาม คู่มือเริ่มใช้งานฉบับย่อ ซึ่งจะแนะนำขั้นตอนสำคัญทั้งหมด รวมถึงการตั้งค่าบัญชี Google Ads

การใช้งานพื้นฐาน

เริ่มต้น GoogleAdsClient ด้วยการตั้งค่าการกำหนดค่าและดึงข้อมูลไคลเอ็นต์บริการเพื่อทำการเรียก API ดังนี้

GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
    client.GetService(Services.V26.GoogleAdsService);

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ไลบรารีของไคลเอ็นต์ .NET ได้ในคู่มือการใช้งานพื้นฐาน

การให้สิทธิ์และการตรวจสอบสิทธิ์

ไลบรารีของไคลเอ็นต์ .NET รองรับวิธีการตรวจสอบสิทธิ์และการให้สิทธิ์หลายวิธี ซึ่งรวมถึงข้อมูลเข้าสู่ระบบของผู้ใช้ OAuth 2.0 (สำหรับแอปพลิเคชันบนเดสก์ท็อปและเว็บ) บัญชีบริการ ข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน (v24.1.0 ขึ้นไป) และการแทรกข้อมูลเข้าสู่ระบบด้วยตนเอง (v27.0.0 ขึ้นไป) ดูข้อมูลเพิ่มเติมได้ในคู่มือการให้สิทธิ์และการตรวจสอบสิทธิ์ และการตรวจสอบสิทธิ์

การกำหนดค่าและการบันทึก

ไลบรารีของไคลเอ็นต์ .NET รองรับตัวเลือกการกำหนดค่า และการบันทึกหลายตัวเลือกโดยใช้ออบเจ็กต์รันไทม์ ไฟล์App.config ไฟล์การกำหนดค่าJSON หรือตัวแปรสภาพแวดล้อม หากต้องการแก้ไข ลักษณะการทำงานของการบันทึกของไลบรารีของไคลเอ็นต์ โปรดดู คู่มือตัวสกัดกั้น gRPC ที่กำหนดเอง

ยูทิลิตี

ไลบรารีของไคลเอ็นต์ .NET มีคลาสยูทิลิตีเพื่อปรับปรุงความสามารถในการใช้งาน API ซึ่งรวมถึงตัวช่วยอัปโหลดสื่อและวิดีโอ (UploadVideo ใน v27.2.0 ขึ้นไป) ดูข้อมูลเพิ่มเติมได้ในคู่มือต่อไปนี้

ปรับแต่งประสิทธิภาพของแอปพลิเคชัน

ดูคำแนะนำเกี่ยวกับวิธีปรับแต่งประสิทธิภาพของแอปพลิเคชันได้ในคู่มือการปรับแต่งประสิทธิภาพ