หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เมื่อต้องการเริ่มต้นการพัฒนาแอปพลิเคชัน Bing Ads API ด้วยภาษา .NET คุณสามารถเริ่มต้นด้วยตัวอย่างที่ให้มา หรือทําตามหนึ่งในคําแนะนําแอปพลิเคชันสําหรับแอปพลิเคชันบนเว็บหรือเดสก์ท็อป ตัวอย่างได้รับการพัฒนาด้วย Bing Ads .NET SDK และ Visual Studio Community การกําหนดค่าแบบกําหนดเองของคุณอาจแตกต่างกัน
คุณจะต้องมีข้อมูลประจําตัวผู้ใช้ที่มีสิทธิ์เข้าถึง Microsoft Advertising ทั้งในการผลิตหรือ Sandbox สําหรับสภาพแวดล้อมการผลิต คุณจะต้องมีโทเค็นนักพัฒนาผลิต ไคลเอ็นต์ Sandbox ทั้งหมดสามารถใช้โทเค็นนักพัฒนา Sandbox สากลได้ เช่น BBD37VB98 สําหรับข้อมูลเพิ่มเติม โปรดดูเริ่มต้นใช้งาน API Bing Ads และ Sandbox
หากต้องการรับรองความถูกต้องผ่าน OAuth คุณต้องลงทะเบียนแอปพลิเคชันและรับตัวระบุไคลเอ็นต์ที่สอดคล้องกัน คุณยังต้องจดบันทึกข้อมูลลับของไคลเอ็นต์และเปลี่ยนเส้นทาง URI ถ้าคุณกําลังพัฒนาแอปพลิเคชันบนเว็บ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับการลงทะเบียนแอปพลิเคชันในการผลิตและขั้นตอนการให้รหัสการให้สิทธิ์ โปรดดูการรับรองความถูกต้องด้วย OAuth และการรับรองความถูกต้องด้วย SDK แม้ว่าในการผลิตคุณต้องใช้ ID แอปพลิเคชันของคุณเอง (a.k.a. client ID) ลูกค้า Microsoft Advertising ทั้งหมดสามารถใช้ ID ไคลเอ็นต์ "แอปตัวอย่างบทช่วยสอน" สาธารณะใน Sandbox เช่น 00001111-aaaa-2222-bbbb-3333cccc4444 สําหรับข้อมูลเพิ่มเติม โปรดดู Sandbox
ติดตั้ง SDK
ติดตั้ง Bing Ads .NET SDK ผ่าน NuGet ผ่านส่วนติดต่อผู้ใช้ Manage NuGet Packages หรือผ่านคอนโซลตัวจัดการแพคเกจ สําหรับข้อมูลเกี่ยวกับการติดตั้ง NuGet ให้ดูที่https://docs.nuget.org
หมายเหตุ
Bing Ads .NET SDK สนับสนุน .NET Standard 2.0 คุณสามารถเลือกได้จากหลากหลายแพลตฟอร์ม เช่น .NET Core หรือ .NET Framework 4.6.1 ตัวอย่าง Bing Ads API ได้รับการพัฒนาผ่าน Visual Studio Community 2017 และ.NET Framework เป้าหมาย 4.7.1 .NET Standard 2.0 และ Bing Ads .NET SDK ไม่สนับสนุนรุ่น.NET Framework ที่ต่ํากว่า 4.6.1 สําหรับข้อมูลเพิ่มเติมเกี่ยวกับ .NET Standard และวิธีการที่เกี่ยวข้องกับ .NET frameworks อื่นๆ โปรดดูที่บทความนี้บน .NET Standard
NuGet Package Manager Console
- คลิกที่ เครื่องมือ ->ตัวจัดการแพคเกจ NuGet ->คอนโซลตัวจัดการแพคเกจ
- เลือกโครงการเริ่มต้นที่คุณต้องการติดตั้ง SDK จากนั้นภายในบรรทัดคําสั่งคอนโซล ให้พิมพ์
Install-Package Microsoft.BingAds.SDK - ถ้าคุณยังไม่มีการอ้างอิงไปยัง System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 และ System.ServiceModel.ConfigurationManager 4.4.1 พิมพ์
Install-Package System.ServiceModel.Primitives -Version 4.4.1Install-Package System.ServiceModel.Http -Version 4.4.1และInstall-Package System.Configuration.ConfigurationManager -Version 4.4.1
การฝึกปฏิบัติ
เมื่อคุณติดตั้ง Bing Ads .NET SDK แล้ว คุณสามารถเรียกดู Bing Ads ตัวอย่างรหัส API ใน C# หรือทําตามหนึ่งในคําแนะนําแอปพลิเคชันสําหรับแอปพลิเคชันเว็บหรือเดสก์ท็อป
การกําหนดไคลเอ็นต์ HTTP เอง
คุณอาจต้องการกําหนดไคลเอ็นต์ HTTP ที่ใช้โดย Bing Ads .NET SDK เพื่อเปลี่ยนพารามิเตอร์มาตรฐานบางอย่าง เช่น HTTP หมดเวลา การกําหนดค่าพร็อกซี หรือการตั้งค่าอื่น ๆ
เมื่อต้องการทําเช่นนั้น คุณสามารถสร้างคลาสแบบกําหนดเองที่สืบทอดมา HttpClientProvider และตั้งค่า GlobalSettings.HttpClientProvider เป็นอินสแตนซ์ของคลาสนั้นก่อนที่จะเรียกใช้บริการได้ ตัวอย่างเช่น:
class MyHttpClientProvider : HttpClientProvider
{
protected override void ConfigureHttpClient(HttpClient httpClient, Type serviceType, ApiEnvironment apiEnvironment)
{
// override default timeout
httpClient.Timeout = TimeSpan.FromMinutes(5);
}
}
GlobalSettings.HttpClientProvider = new MyHttpClientProvider();
การบันทึกการเรียกบริการ
เริ่มต้นจาก Bing Ads .NET SDK 13.0.20 เพื่อเปิดใช้งานการร้องขอการบันทึกและข้อความตอบกลับ คุณสามารถตั้งค่า BINGADS_ConsoleLoggerMinLevel ตัวแปรสภาพแวดล้อมเป็น Verbose:
Environment.SetEnvironmentVariable("BINGADS_ConsoleLoggerMinLevel", "Verbose");
คุณยังสามารถเปิดใช้งานการบันทึกเดียวกันโดยใช้คลาส:BingAdsEventListener
BingAdsEventListener.CreateConsoleLogger(EventLevel.Verbose).KeepActive();
คุณยังสามารถสร้างอินสแตนซ์ใหม่ BingAdsEventListener เพื่อให้มีการใช้งานตัวบันทึกแบบกําหนดเองได้ ตัวอย่างเช่น:
new BingAdsEventListener(EventLevel.Verbose, bingAdsEvent => MyLogger.LogVerbose(bingAdsEvent.GetDescription())).KeepActive();
ดูเพิ่มเติม
ไลบรารีไคลเอ็นต์ Bing Ads API
ตัวอย่างโค้ด API Bing Ads
ที่อยู่บริการเว็บ Bing Ads API
การจัดการข้อผิดพลาดและข้อยกเว้นของบริการ
กระบะทราย