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

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

ไลบรารีรองรับ .NET Framework ต่อไปนี้

  • .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

ไลบรารี .NET ของ Google Ads API ใช้ 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.V25.GoogleAdsService);

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

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

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

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

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

ยูทิลิตี

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

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

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