Developer Knowledge API

Developer Knowledge API ให้สิทธิ์เข้าถึงเอกสารประกอบสำหรับนักพัฒนาแอปแบบสาธารณะของ Google แบบเป็นโปรแกรม ซึ่งช่วยให้คุณผสานรวมฐานความรู้นี้เข้ากับแอปพลิเคชันและเวิร์กโฟลว์ของคุณเองได้

ภาพรวม

Developer Knowledge API ออกแบบมาให้เป็นแหล่งข้อมูลที่เชื่อถือได้สำหรับการเข้าถึงเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ของ Google ในรูปแบบที่เครื่องอ่านได้ โดยมีฟังก์ชัน ในการค้นหาและดึงข้อมูลเอกสาร รวมถึงตอบคำค้นหา ดังนี้

  • SearchDocumentChunks เพื่อค้นหา URI ของหน้าและข้อมูลโค้ดเนื้อหาที่เกี่ยวข้องตามคำค้นหา
  • GetDocument หรือ BatchGetDocuments เพื่อดึงเนื้อหาทั้งหมดของผลการค้นหา
  • AnswerQuery เพื่อรับคำตอบสำหรับคำถามที่อิงตามคลังเอกสาร

หากต้องการเริ่มต้นใช้งานอย่างรวดเร็ว ให้ทำตามคู่มือเริ่มใช้งานฉบับย่อ

คลังเนื้อหาที่ค้นหาได้แสดงอยู่ในการอ้างอิงคลัง

Developer Knowledge API รองรับการค้นหาและดึงข้อมูลหน้าเอกสารประกอบเป็นเนื้อหา Markdown ที่ไม่มีโครงสร้าง

เปิดใช้ API

หากต้องการใช้ Developer Knowledge API คุณต้องเปิดใช้ API ดังกล่าวก่อนสำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

  1. เปิดหน้า Developer Knowledge API ในไลบรารี Google APIs
  2. ตรวจสอบว่าคุณได้เลือกโปรเจ็กต์ที่ถูกต้องซึ่งคุณต้องการใช้ API
  3. คลิกเปิดใช้ ไม่จำเป็นต้องมีบทบาท IAM ที่เฉพาะเจาะจงเพื่อเปิดใช้หรือใช้ API

การตรวจสอบสิทธิ์

ต้องระบุคีย์ API ของ Developer Knowledge เพื่อใช้ Developer Knowledge API วิธีสร้าง

  1. ในคอนโซล Google Cloud สำหรับโปรเจ็กต์ที่คุณเปิดใช้ API ให้ไปที่หน้าข้อมูลเข้าสู่ระบบ
  2. คลิกสร้างข้อมูลเข้าสู่ระบบ แล้วเลือกคีย์ API จากเมนู
  3. ระบุชื่อคีย์ในช่องชื่อ
  4. คลิกเมนูแบบเลื่อนลงเลือกการจำกัด API แล้วพิมพ์ Developer Knowledge API คลิกผลการค้นหา แล้วคลิก OK
    • หมายเหตุ: หากเพิ่งเปิดใช้ Developer Knowledge API ระบบอาจใช้เวลาสักพักก่อนที่ API จะปรากฏในรายการ โปรดรอสักครู่แล้วลองอีกครั้ง
  5. คลิกสร้าง

ระบุคีย์ API ของ Developer Knowledge นี้ในคำขอของคุณ เช่น การเรียก REST ควรมีพารามิเตอร์การค้นหา key ดูตัวอย่างได้ในคู่มือเริ่มใช้งานฉบับย่อ

เอกสารที่รวมอยู่

ดูข้อมูลเกี่ยวกับเอกสารที่ API ค้นหาได้ที่ข้อมูลอ้างอิงของคลัง

ข้อจำกัดที่ทราบ

  • คุณภาพของมาร์กดาวน์: มาร์กดาวน์สร้างขึ้นจาก HTML ต้นฉบับ อาจมีความคลาดเคลื่อนหรือปัญหาการจัดรูปแบบ
  • ขอบเขตเนื้อหา: ระบบจะรวมเฉพาะเพจสาธารณะในการอ้างอิงคลังข้อความ เนื้อหาจากแหล่งที่มาอื่นๆ เช่น GitHub, เว็บไซต์ OSS, บล็อก หรือ YouTube จะไม่รวมอยู่ด้วย