หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เมื่อต้องการเริ่มต้นใช้งานการพัฒนาแอปพลิเคชัน Bing Ads API ด้วยภาษา .NET คุณสามารถเริ่มต้นด้วยตัวอย่างที่ให้ไว้หรือทําตามคําแนะนําแอปพลิเคชันสําหรับแอปพลิเคชันบนเว็บหรือเดสก์ท็อป ตัวอย่างได้รับการพัฒนาโดยใช้ Bing Ads .NET SDK และชุมชน Visual Studio การกําหนดค่าแบบกําหนดเองของคุณอาจแตกต่างกัน
คุณจะต้องมีข้อมูลประจําตัวผู้ใช้ที่มีสิทธิ์เข้าถึง Microsoft Advertising ทั้งในการผลิตหรือแบบ Sandbox สําหรับสภาพแวดล้อมการใช้งานจริง คุณจะต้องใช้โทเค็นนักพัฒนาการผลิต ไคลเอ็นต์ Sandbox ทั้งหมดสามารถใช้โทเค็นสําหรับนักพัฒนา Universal Sandbox ได้ เช่น BBD37VB98 สําหรับข้อมูลเพิ่มเติม โปรดดู เริ่มต้นใช้งาน Bing Ads API และ Sandbox
เมื่อต้องการรับรองความถูกต้องผ่าน OAuth คุณต้องลงทะเบียนแอปพลิเคชันและรับตัวระบุไคลเอ็นต์ที่สอดคล้องกัน นอกจากนี้ คุณยังต้องจดบันทึกข้อมูลลับไคลเอ็นต์และ URI การเปลี่ยนเส้นทาง ถ้าคุณกําลังพัฒนาเว็บแอปพลิเคชัน สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับการลงทะเบียนแอปพลิเคชันในการผลิตและขั้นตอนการให้รหัสการตรวจสอบสิทธิ์ โปรดดู การรับรองความถูกต้องด้วย OAuth และการรับรองความถูกต้องด้วย SDK แม้ว่าในการผลิต คุณจะต้องใช้รหัสแอปพลิเคชันของคุณเอง (หรือที่เรียกว่า ID ไคลเอ็นต์) แต่ลูกค้า Microsoft Advertising ทั้งหมดสามารถใช้ ID ไคลเอ็นต์ "แอปตัวอย่างบทช่วยสอน" สาธารณะใน Sandbox ได้ เช่น 00001111-aaaa-2222-bbbb-3333cccc4444 สําหรับข้อมูลเพิ่มเติม โปรดดู Sandbox
ติดตั้ง SDK
ติดตั้ง Bing Ads .NET SDK ผ่าน NuGet ไม่ว่าจะผ่านส่วนติดต่อผู้ใช้จัดการแพคเกจ NuGet หรือผ่านคอนโซลตัวจัดการแพคเกจ สําหรับข้อมูลเกี่ยวกับการติดตั้ง 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 Framework อื่นๆ อย่างไร โปรดดูบทความนี้เกี่ยวกับ .NET Standard
คอนโซลตัวจัดการชุดรวมแฟ้ม NuGet
- คลิกเครื่องมือ -NuGet>โปรแกรมจัดการชุดรวมแฟ้ม -Package>Manager Console
- เลือกโครงการเริ่มต้นที่คุณต้องการติดตั้ง 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.1,Install-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
การจัดการข้อผิดพลาดและข้อยกเว้นของบริการ
Sandbox