หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เมื่อต้องการใช้ API เนื้อหา คุณจําเป็นต้องมีสองอย่างดังนี้:
- บัญชี Microsoft
- บัญชี Microsoft Advertising
- โทเค็นสําหรับนักพัฒนา
เมื่อต้องการรับบัญชี Microsoft Advertising ให้ไปที่https://ads.microsoft.com ถ้าคุณไม่ได้ลงชื่อเข้าใช้บัญชี Microsoft ของคุณ คุณจะถูกเปลี่ยนเส้นทางไปยังการลงชื่อเข้าใช้บัญชีของคุณหรือลงทะเบียนบัญชี หลังจากลงชื่อเข้าใช้ คุณจะมีตัวเลือกให้ลงทะเบียนบัญชี Microsoft Advertising ใหม่ เลือกตัวเลือกการลงทะเบียน แล้วคลิกดําเนินการต่อ
ถัดไป ถ้าคุณยังไม่มีโทเค็นนักพัฒนา Microsoft Advertising สําหรับสภาพแวดล้อมการใช้งาน ให้ไปที่พอร์ทัลนักพัฒนา คลิก ร้องขอโทเค็น และใส่ข้อมูลที่ร้องขอ ถ้าคุณใช้ API เพื่อจัดการบัญชีของคุณเอง คุณจะได้รับโทเค็นของคุณทันที แต่หากคุณจัดการบัญชีให้ผู้อื่น อาจใช้เวลาถึง 5 วันทําการเพื่อรับโทเค็น
การรับรองความถูกต้องข้อมูลประจําตัวของคุณ
สิ่งสำคัญ
ตั้งแต่วันที่ 1 มิถุนายน 2022 เราจะกําหนดให้มีการรับรองความถูกต้องโดยใช้หลายปัจจัยสําหรับผู้ใช้ทุกคนที่ลงชื่อเข้าใช้ผ่านแอปพลิเคชันของบริษัทภายนอกที่ใช้ Bing Ads API, Content API และ Hotel API
คุณต้องอัปเดตแอปพลิเคชันของคุณเพื่อรับความยินยอมจากผู้ใช้โดยใช้ขอบเขตใหม่msads.manage นักพัฒนาแอปพลิเคชันทั้งหมดต้องดําเนินการเพื่อใช้ขอบเขตใหม่
สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือข้อกําหนดการรับรองความถูกต้องโดยใช้หลายปัจจัย
API เนื้อหาใช้แบบแผนการรับรองความถูกต้องเดียวกันกับ Bing Ads API สําหรับรายละเอียดเกี่ยวกับการรับรองความถูกต้องข้อมูลประจําตัวของบัญชี Microsoft ด้วย OAuth ให้ดู การรับรองความถูกต้องด้วยแพลตฟอร์มข้อมูลประจำตัวของ Microsoft
คุณสามารถใช้Bing Ads SDK สําหรับ .NET, Java หรือ Python เพื่อตรวจสอบสิทธิ์ข้อมูลประจําตัวของบัญชี Microsoft ได้ สําหรับรายละเอียดเกี่ยวกับการใช้ SDK เพื่อรับโทเค็นการเข้าถึง ให้ดู C# | Java | Python สําหรับตัวอย่าง Content API ที่ใช้ SDK สําหรับการรับรองความถูกต้อง ให้ดูตัวอย่างการจัดการผลิตภัณฑ์
(โปรดทราบว่า Bing Ads SDK ไม่มีส่วนติดต่อสําหรับ Content API คุณควรใช้ SDK เพื่อรับโทเค็นการเข้าถึงเท่านั้น หากคุณใช้ SDK สําหรับแคมเปญ Microsoft Advertising ด้วย มิฉะนั้น อาจไม่คุ้มค่ากับค่าใช้จ่ายในการติดตั้ง SDK)
หากคุณไม่ได้ใช้ Bing Ads SDK สําหรับการรับรองความถูกต้อง ให้ดู การรับรองความถูกต้องข้อมูลประจําตัวบัญชี Microsoft ใน C# สําหรับตัวอย่างที่แสดงวิธีการใช้ OAuth เพื่อรับรองความถูกต้องข้อมูลประจําตัวของบัญชี Microsoft
ฉันจะใช้ข้อมูลประจําตัวและโทเค็นนักพัฒนาของคุณได้ที่ไหน
การโทรทั้งหมดต้องระบุ:
- ส่วนหัว DeveloperToken ที่ตั้งค่าเป็นโทเค็นนักพัฒนาของคุณ
- ส่วนหัว AuthenticationToken ที่ตั้งค่าเป็นโทเค็นการเข้าถึงของคุณ
ถ้าคุณจัดการแค็ตตาล็อกในนามของลูกค้ารายอื่นๆ คุณต้องตั้งค่าส่วนหัวต่อไปนี้ด้วย
- ส่วนหัว CustomerId ที่ถูกตั้งค่าเป็น ID ลูกค้าของลูกค้าที่คุณกําลังจัดการร้านค้า
- ส่วนหัว CustomerAccountId ที่ถูกตั้งค่าเป็น ID บัญชีของบัญชีของลูกค้าใดๆ ที่คุณจัดการ (ไม่เกี่ยวกับบัญชีที่จัดการ)
สําหรับข้อมูลเกี่ยวกับส่วนหัวเหล่านี้และส่วนหัวอื่นๆ ที่การร้องขอและการตอบกลับอาจมีอยู่ ให้ดูส่วนหัว
การกําหนดค่า Microsoft Merchant Center ให้ใช้ API
สําหรับภาพรวมของ Microsoft Merchant Center (MMC) ให้ดู Microsoft Merchant Center คืออะไร หัวข้อนี้มีลิงก์ไปยังหัวข้อ Merchant Center ทั้งหมดและวิดีโอที่เกี่ยวข้อง
คุณต้องทําตามขั้นตอนต่อไปนี้ ถ้าคุณยังไม่ได้ดําเนินการ
- ยืนยันและอ้างสิทธิ์ URL ของเว็บไซต์ของคุณ เมื่อต้องการรับเครื่องมือเว็บมาสเตอร์ที่กล่าวถึงใน ยืนยันและอ้างสิทธิ์ URL ของเว็บไซต์ของคุณ ให้ดู เครื่องมือเว็บมาสเตอร์ของ Bing ลงชื่อเข้าใช้ด้วยบัญชี Microsoft เดียวกันกับที่คุณใช้สําหรับ Microsoft Advertising สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้เครื่องมือ ให้ดู ยืนยันความเป็นเจ้าของเว็บไซต์ของคุณ
- สร้าง Microsoft Merchant Center Store
- เพิ่มแค็ตตาล็อก
เมื่อคุณสร้างร้านค้า MMC กระบวนการจะสร้างแค็ตตาล็อกเริ่มต้นสําหรับคุณ Store และแค็ตตาล็อกทั้งหมดที่คุณสร้างจะเปิดใช้งานการจัดการ API โดยอัตโนมัติ Store มีแค็ตตาล็อกเริ่มต้นที่การดําเนินการผลิตภัณฑ์ทั้งหมด (เพิ่ม อัปเดต ลบ และรับ) นําไปใช้กับตามค่าเริ่มต้น เมื่อต้องการระบุแค็ตตาล็อกอื่น ให้ใช้พารามิเตอร์แบบสอบถาม bmc-catalog-id ใน URL ทรัพยากร
เมื่อต้องการเพิ่มและเปิดใช้งานแค็ตตาล็อก ให้ใช้ทรัพยากรแค็ตตาล็อก สําหรับข้อมูลเพิ่มเติม ให้ดูที่ การจัดการแค็ตตาล็อกของคุณ
หมายเหตุ
ในบางสถานการณ์ คุณสามารถใช้ API และ FTP/SFTP เพื่ออัปเดตฟีดแค็ตตาล็อกได้ สําหรับข้อมูลเกี่ยวกับการใช้ API กับ FTP/SFTP ให้ดูที่ ฉันสามารถใช้ API และ FTP/SFTP ได้หรือไม่
ขั้นตอนถัดไป
ตอนนี้คุณพร้อมที่จะเริ่มต้นใช้งาน API ให้ดูส่วนต่อไปนี้