Developer Knowledge API

Developer Knowledge API menyediakan akses terprogram ke dokumentasi developer publik Google, sehingga Anda dapat mengintegrasikan pusat informasi ini ke dalam aplikasi dan alur kerja Anda sendiri.

Ringkasan

Developer Knowledge API dirancang untuk menjadi sumber kanonis bagi akses yang dapat dibaca mesin ke dokumentasi developer Google. API ini menawarkan fungsi untuk menelusuri dan mengambil dokumen, serta menjawab kueri:

• SearchDocumentChunks untuk menemukan URI halaman dan cuplikan konten yang relevan berdasarkan kueri.
• GetDocument atau BatchGetDocuments untuk mengambil konten lengkap hasil penelusuran.
• AnswerQuery untuk membuat jawaban atas kueri yang diambil dari korpus dokumentasi.

Developer Knowledge API mendukung penelusuran dan pengambilan halaman dokumentasi sebagai konten Markdown tidak terstruktur. Korpus konten yang dapat ditelusuri tercantum dalam Referensi korpus.

Cara menggunakan Pengetahuan Developer

Anda dapat mengakses Pengetahuan Developer melalui platform berikut, bergantung pada alur kerja Anda:

• REST API dan RPC API: panggil endpoint HTTP atau gRPC secara langsung. Lihat referensi REST dan referensi RPC untuk spesifikasi metode.
• Library klien: mengintegrasikan Developer Knowledge API ke dalam aplikasi Anda menggunakan library klien resmi untuk Python, Node.js dan TypeScript, Go, Java, PHP, dan Ruby.
• Google Cloud CLI (gcloud): jalankan perintah gcloud developer-knowledge dari terminal Anda untuk menelusuri chunk dokumen, mengambil konten Markdown, dan membuat jawaban.
• Server MCP Developer Knowledge: hubungkan asisten atau agen coding AI Anda ke dokumentasi Google menggunakan alat Model Context Protocol (MCP) (search_documents, get_documents, dan answer_query). Lihat referensi MCP.

Tips: Jika Anda menggunakan asisten coding AI, instal kemampuan agen retrieving-developer-knowledge dengan menjalankan npx skills add google/skills --skill retrieving-developer-knowledge. Keterampilan ini memberikan petunjuk bawaan kepada asisten Anda tentang alat server MCP Pengetahuan Developer mana yang harus dipilih, cara menangani error, dan cara memanggil REST API dengan curl jika server MCP tidak tersedia. Untuk mempelajari lebih lanjut, lihat Menggunakan keterampilan agen Developer Knowledge.

Memilih antara API dan server MCP

Developer Knowledge API dan server MCP Developer Knowledge dirancang untuk kebutuhan integrasi yang berbeda:

• Gunakan Developer Knowledge API, library klien, atau gcloud CLI saat:
  • Project Anda tidak menggunakan agen AI.
  • Anda ingin menentukan alat atau set alat kustom untuk agen Anda.
  • Anda ingin memproses atau menggabungkan hasil sebelum meneruskannya ke model (misalnya, memeriksa panjang byte dokumen sebelum mengambil konten lengkap).
  • Anda perlu memfilter hasil penelusuran (seperti menurut data_source atau update_time) atau menerapkan masker kolom.
• Gunakan server MCP Pengetahuan Developer dan kemampuan agen saat:
  • Anda ingin menghubungkan asisten atau agen coding AI tanpa menulis definisi dan deskripsi alat kustom.
  • Anda menginginkan update otomatis saat server MCP Pengetahuan Developer menambahkan kemampuan baru.
  • Anda tidak memerlukan pemfilteran metadata kustom pada hasil penelusuran.

Mengaktifkan API

Untuk menggunakan Developer Knowledge API, Anda harus mengaktifkannya terlebih dahulu untuk project Google Cloud Anda.

Tips: Jika Anda tidak memiliki project Google Cloud, buat project menggunakan petunjuk Google Cloud atau Firebase.

1. Buka halaman Developer Knowledge API di library API Google.
2. Pastikan Anda telah memilih project yang benar tempat Anda ingin menggunakan API.
3. Klik Enable. Tidak ada peran IAM tertentu yang diperlukan untuk mengaktifkan atau menggunakan API.

Autentikasi

Anda dapat mengautentikasi permintaan ke Developer Knowledge API menggunakan salah satu metode berikut:

• Kunci API: mengautentikasi permintaan REST langsung atau server MCP Pengetahuan Developer menggunakan parameter kueri key atau header X-Goog-Api-Key.
• Kredensial Default Aplikasi (ADC), OAuth 2.0, atau akun layanan: mengautentikasi permintaan saat menggunakan library klien resmi atau alur kerja produksi. Untuk mempelajari lebih lanjut cara menyiapkan kredensial, lihat dokumentasi Kredensial Default Aplikasi.
• Kredensial pengguna (gcloud CLI): mengautentikasi permintaan CLI dengan login ke akun Google Cloud Anda menggunakan gcloud auth login. Lihat panduan memulai gcloud CLI untuk mengetahui petunjuk penyiapan.

Dokumentasi yang disertakan

Lihat Referensi korpus untuk mengetahui informasi tentang dokumen mana yang dicari oleh API.

Developer Knowledge API bertujuan untuk menyediakan akses ke dokumentasi developer Google terbaru. Tujuan kami adalah mengindeks ulang konten dalam waktu 48 jam setelah dipublikasikan sehingga dokumentasi baru atau yang diperbarui tersedia dalam waktu 2 hari kerja.

Batasan umum

• Kualitas Markdown: Markdown dihasilkan dari HTML sumber. Mungkin ada perbedaan atau masalah pemformatan.
• Cakupan Konten: Hanya halaman publik di Referensi korpus yang disertakan. Konten dari sumber lain seperti GitHub, situs OSS, blog, atau YouTube tidak disertakan.