เริ่มต้นใช้งาน API เนื้อหา

  • บทความ

หากต้องการใช้ API เนื้อหา คุณจะต้องมีสองสามสิ่งต่อไปนี้:

  1. บัญชี Microsoft
  2. บัญชี Microsoft Advertising
  3. โทเค็นนักพัฒนา

หากต้องการรับบัญชี Microsoft Advertising ให้ไปที่https://ads.microsoft.com ถ้าคุณไม่ได้ลงชื่อเข้าใช้บัญชี Microsoft คุณจะถูกเปลี่ยนเส้นทางเพื่อลงชื่อเข้าใช้บัญชีของคุณ หรือเพื่อลงทะเบียนบัญชี หลังจากลงชื่อเข้าใช้แล้ว คุณจะมีตัวเลือกในการลงทะเบียนสําหรับบัญชี Microsoft Advertising ใหม่ เลือกตัวเลือกลงทะเบียน และคลิกดําเนินการต่อ

ถัดไป ถ้าคุณยังไม่มีโทเค็นนักพัฒนาโฆษณา Microsoft สําหรับสภาพแวดล้อมการผลิต ให้ไปที่ พอร์ทัลนักพัฒนา คลิก ร้องขอโทเค็น และใส่ข้อมูลที่ร้องขอ ถ้าคุณใช้ API เพื่อจัดการบัญชีของคุณเอง คุณจะได้รับโทเค็นของคุณทันที อย่างไรก็ตาม ถ้าคุณกําลังจัดการบัญชีสําหรับผู้อื่น อาจใช้เวลาถึงห้าวันทําการในการรับโทเค็น

การรับรองความถูกต้องข้อมูลประจําตัวของคุณ

สิ่งสำคัญ

ตั้งแต่วันที่ 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 สําหรับตัวอย่าง API เนื้อหาที่ใช้ SDK สําหรับการรับรองความถูกต้อง โปรดดูตัวอย่างการจัดการผลิตภัณฑ์

(โปรดทราบว่า SDK โฆษณา Bing ไม่มีอินเทอร์เฟซสําหรับ API ของเนื้อหา คุณควรใช้ SDK เพื่อรับโทเค็นการเข้าถึงหากคุณใช้ SDK สําหรับแคมเปญโฆษณา Microsoft เท่านั้น มิฉะนั้นอาจไม่คุ้มค่ากับค่าใช้จ่ายในการติดตั้ง 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 และวิดีโอที่เกี่ยวข้องทั้งหมด

คุณต้องทําตามขั้นตอนต่อไปนี้ถ้าคุณยังไม่ได้ดําเนินการดังกล่าว

  1. ตรวจสอบและอ้างสิทธิ์ URL ของเว็บไซต์ของคุณ หากต้องการรับเครื่องมือสําหรับเว็บมาสเตอร์ที่กล่าวถึงในตรวจสอบและอ้างสิทธิ์ URL ของเว็บไซต์ของคุณ โปรดดูเครื่องมือสําหรับเว็บมาสเตอร์ของ Bing ลงชื่อเข้าใช้ด้วยบัญชี Microsoft เดียวกันกับที่คุณใช้สําหรับการโฆษณาของ Microsoft สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้เครื่องมือ ดูตรวจสอบความเป็นเจ้าของเว็บไซต์ของคุณ
  2. สร้างร้านค้า Microsoft Merchant Center
  3. เพิ่มแค็ตตาล็อก

เมื่อคุณสร้างที่เก็บ MMC กระบวนการจะสร้างแค็ตตาล็อกเริ่มต้นสําหรับคุณ ร้านค้าและแค็ตตาล็อกทั้งหมดที่คุณสร้างจะเปิดใช้งานสําหรับการจัดการ API โดยอัตโนมัติ ร้านค้ามีแค็ตตาล็อกเริ่มต้นที่นําการดําเนินการของผลิตภัณฑ์ทั้งหมด (เพิ่ม อัปเดต ลบ และรับ) ไปใช้ตามค่าเริ่มต้น เมื่อต้องการระบุแค็ตตาล็อกอื่น ให้ใช้พารามิเตอร์คิวรี bmc-catalog-id ใน URL ทรัพยากร

เมื่อต้องการเพิ่มและเปิดใช้งานแค็ตตาล็อก ให้ใช้ทรัพยากรแค็ตตาล็อก สําหรับข้อมูลเพิ่มเติม ให้ดู การจัดการแค็ตตาล็อกของคุณ

หมายเหตุ

ในบางกรณี คุณสามารถใช้ API และ FTP/SFTP เพื่ออัปเดตตัวดึงข้อมูลแค็ตตาล็อกได้ สําหรับข้อมูลเกี่ยวกับการใช้ API กับ FTP/SFTP โปรดดู ฉันสามารถใช้ API และ FTP/SFTP ได้หรือไม่

ขั้นตอนถัดไป

ตอนนี้คุณพร้อมที่จะเริ่มใช้ API แล้ว ให้ดูส่วนต่อไปนี้