Developer Knowledge API

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

ภาพรวม

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

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

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

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

หมายเหตุสำหรับเวอร์ชันตัวอย่าง: เวอร์ชันตัวอย่างนี้รองรับการค้นหาและ การดึงข้อมูลหน้าเอกสารประกอบเป็นเนื้อหา 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 จากเมนู กล่องโต้ตอบคีย์ API ที่สร้างขึ้นจะแสดงสตริงสำหรับคีย์ที่สร้างขึ้นใหม่
  3. คลิกแก้ไขคีย์ API
  4. ระบุชื่อคีย์ในช่องชื่อ
  5. เลือกจำกัดคีย์ในส่วนการจำกัด API
  6. จากรายการ Select APIs ให้เปิดใช้ Developer Knowledge API แล้วคลิก OK
    • หมายเหตุ: หากเพิ่งเปิดใช้ Developer Knowledge API อาจมีความล่าช้าก่อนที่ API จะปรากฏในรายการเลือก API
  7. คลิกบันทึก

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

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

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

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

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