คําถามที่ถามบ่อยเกี่ยวกับแค็ตตาล็อก API Microsoft Learn

บทความ
04/03/2023

บทความนี้แสดงรายการคําถามที่ถามบ่อยเกี่ยวกับแค็ตตาล็อก API Microsoft Learn พร้อมคําตอบและลิงก์ไปยังข้อมูลเพิ่มเติมตามความจําเป็น

ทั่วไป

ถ: ต้องใช้ API แค็ตตาล็อก Learn เท่าไร

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

ถ: กฎสําหรับการใช้แค็ตตาล็อก API Learn มีอะไรบ้าง

ดูเงื่อนไขการใช้ Microsoft Learn และ Microsoft API

ถ: ฉันจําเป็นต้องออนบอร์ดหรือรับคีย์เพื่อใช้ API แค็ตตาล็อก Learn หรือไม่

ไม่ใช่ API พร้อมใช้งานแบบสาธารณะ ดูบทความเริ่มต้นใช้งาน ด้วยแค็ตตาล็อก API Learn โดยใช้บทความ cURL และ Visual Studio Code และ/หรือ บทความการอ้างอิงสําหรับนักพัฒนา API แค็ตตาล็อก Learn

ถ: API นี้จะช่วยให้ผู้ใช้ของเราใช้เนื้อหา Learn ภายในแพลตฟอร์มของเราได้หรือไม่

ไม่ใช่ แค็ตตาล็อก API Learn มีเมตาดาต้าเกี่ยวกับเนื้อหา และลิงก์ไปยังเนื้อหาโดยตรง ผู้ใช้สามารถรวมลิงก์เหล่านี้ลงใน LMS หรือประสบการณ์เว็บใด ๆ ตามข้อกําหนดการใช้ Microsoft API

ถ: ข้อมูลที่ส่งกลับจาก Learn Catalog API ยังคงคงที่หรือเปลี่ยนแปลงหรือไม่

ข้อมูลจะเปลี่ยนแปลงเมื่อมีการเพิ่ม ปรับเปลี่ยน หรือลบเนื้อหาใหม่ ซึ่งโดยปกติแล้วจะยึดตามรายวัน

การตอบสนอง API

ถ: ฉันสามารถดึงข้อมูลทั้งหมดในครั้งเดียวได้หรือไม่

ใช่ ใช้จุดสิ้นสุดพื้นฐาน learn.microsoft.com/api/catalog เพื่อรับการตอบกลับแบบเต็ม ดูบทความการอ้างอิงสําหรับนักพัฒนาแค็ตตาล็อก Learn API สําหรับข้อมูลคําขอ API เพิ่มเติม

ถ: ฉันสามารถกรองคําตอบไว้ล่วงหน้าได้หรือไม่

ใช่ ดูตัวกรองคิวรีที่พร้อมใช้งานใน บทความการอ้างอิงนักพัฒนาแค็ตตาล็อก Learn แค็ตตาล็อก API

ถ: UIDs ไม่ซ้ํากันสําหรับแต่ละวัตถุเนื้อหาหรือไม่

ใช่ UID หมายถึง "ID ที่ไม่ซ้ํา" และเป็นค่าเฉพาะสําหรับแต่ละวัตถุเนื้อหา ถ้า UID เปลี่ยนแปลง แม้ว่าชื่อเรื่องหรือเมตาดาต้าอื่น ๆ จะยังคงเหมือนเดิม เนื้อหาจะถือว่าเป็นออบเจ็กต์ใหม่

ถ: เพราะเหตุใดจึงมีแท็ก HTML ในข้อมูลสรุปของโมดูล

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

คําถาม: เหตุใดจึงไม่มีลิงก์สําหรับหน่วยแต่ละหน่วย

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

ถ: ฉันจะทราบได้อย่างไรว่าเนื้อหาใดใหม่

ค่า last_modified จะบอกให้คุณทราบเมื่อระเบียนถูกปรับเปลี่ยนล่าสุด

ถ: เปิดใช้งานการลงชื่อเข้าระบบครั้งเดียว (SSO) สําหรับลิงก์เนื้อหาหรือไม่

ไม่ใช่เวลานี้ เรามุ่งมั่นที่จะเปิดใช้งาน SSO ในอนาคต

เนื้อหา

ถ: UID ไม่ซ้ํากันสําหรับเนื้อหาหรือไม่

ถ: มอดูลทั้งหมดเป็นส่วนหนึ่งของเส้นทางการเรียนรู้หรือไม่

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

ถ: ฉันจะทราบได้อย่างไรเมื่อมีการเพิ่ม, รีเฟรช หรือลบเนื้อหา?

เมื่อเพิ่มวัตถุเนื้อหาใหม่ วัตถุเหล่านั้นจะปรากฏเป็นวัตถุใหม่ (ระบุโดย UID) ในการตอบกลับ เมื่อมีการปรับเปลี่ยนเนื้อหา คุณสามารถบอกได้ตามค่า last_modified เมื่อลบเนื้อหา เนื้อหานั้นจะถูกลบออกจากการตอบสนอง แม้ว่าจะมีความล่าช้าเล็กน้อยในการปรับปรุงเนื้อหาในการตอบกลับ API เมื่อผู้ใช้ติดตาม URL ไปยังเนื้อหา ผู้ใช้จะเห็นข้อมูลล่าสุดเสมอ ถ้าเนื้อหาถูกลบ URL เก่าจะเปลี่ยนเส้นทางไปยังเนื้อหาหรือประสบการณ์การใช้งานใหม่

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

ถ: ฉันจะเข้าถึงเอกสารประกอบ วิดีโอ และแค็ตตาล็อกตัวอย่างโค้ดได้อย่างไร

ขณะนี้ยังไม่มีวิธีทางการเขียนโปรแกรมเพื่อเข้าถึงแค็ตตาล็อกเหล่านี้ เรามุ่งมั่นที่จะเปิดใช้งานการเข้าถึงแคตตาล็อกเหล่านี้ทางโปรแกรมในอนาคต

การแปลเป็นภาษาท้องถิ่น

ถ: ภาษาใดบ้างที่พร้อมใช้งานใน Microsoft Learn

มีตําแหน่งที่ตั้งมากกว่า 65 แห่งใน Microsoft Learn คุณสามารถดูรายการทั้งหมดได้ที่นี่ผ่านส่วนท้ายของไซต์ (เลือกภาษาที่คุณกําลังดูเพื่อดูรายการทั้งหมด)

ถ: เนื้อหาพร้อมใช้งานในภาษาอื่นหรือไม่

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

ถ: เนื้อหาสําหรับวัตถุเนื้อหาที่ระบุแตกต่างกันหรือไม่ โดยขึ้นอยู่กับภาษาที่คุณดูใช่หรือไม่

อาจจะ เมื่อมีการเผยแพร่การอัปเดตไปยังเนื้อหาภาษาอังกฤษ ไปป์ไลน์การแปลของเราจะทํางานเพื่อรับการอัปเดตเวอร์ชันที่แปลเป็นภาษาท้องถิ่นโดยเร็วที่สุด – โดยปกติภายในสองสามวันจากการเปลี่ยนแปลงเดิม

อื่นๆ

ถาม: มี API การรายงานหรือฟังก์ชันการทํางานใด ๆ เพื่อรับข้อมูล เช่น มุมมอง การคลิก การทําให้เสร็จสมบูรณ์หรือไม่

เราไม่มี API การรายงานในขณะนี้ เรามีฟังก์ชันการรายงานขององค์กรที่ช่วยให้องค์กรสามารถรายงานว่าผู้ใช้ของพวกเขาเสร็จสมบูรณ์แล้ว

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

คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับแค็ตตาล็อก API การเรียนรู้ โดยไปที่ลิงก์ต่อไปนี้: