Developer Knowledge API, Google'ın herkese açık geliştirici belgelerine programatik erişim sağlayarak bu bilgi tabanını kendi uygulamalarınıza ve iş akışlarınıza entegre etmenize olanak tanır.
Genel Bakış
Developer Knowledge API, Google'ın geliştirici belgelerine makine tarafından okunabilir erişim için standart kaynak olarak tasarlanmıştır. Aşağıdaki işlevleri kullanarak doküman arayabilir, doküman alabilir ve sorguları yanıtlayabilirsiniz:
SearchDocumentChunksSorguya göre alakalı sayfa URI'lerini ve içerik snippet'lerini bulmak için kullanılır.- Arama sonuçlarının tamamını getirmek için
GetDocumentveyaBatchGetDocumentssimgesini tıklayın. AnswerQuery: Dokümanlar külliyatına dayalı sorgulara yanıt almak için kullanılır.
Hızlı bir başlangıç için Hızlı Başlangıç Kılavuzu'nu inceleyin.
Aranabilir içerik derlemi, Corpus referansı'nda listelenir.
Developer Knowledge API, doküman sayfalarının yapılandırılmamış Markdown içeriği olarak aranmasını ve alınmasını destekler.
API'yi etkinleştirme
Developer Knowledge API'yi kullanmak için önce Google Cloud projenizde etkinleştirmeniz gerekir.
- Google API'leri kitaplığında Developer Knowledge API sayfasını açın.
- API'yi kullanmayı planladığınız projeyi doğru seçtiğinizden emin olun.
- Etkinleştir'i tıklayın. API'yi etkinleştirmek veya kullanmak için belirli IAM rolleri gerekmez.
Kimlik doğrulama
Developer Knowledge API'yi kullanmak için Developer Knowledge API anahtarı gerekir. Oluşturmak için:
- API'yi etkinleştirdiğiniz projenin Google Cloud Console'unda Kimlik Bilgileri sayfasına gidin.
- Kimlik bilgileri oluştur'u tıklayın ve menüden API anahtarı'nı seçin.
- Ad alanında anahtar için bir ad girin.
-
API kısıtlamalarını seçin açılır listesini tıklayın ve Developer Knowledge API yazın. Sonucu ve ardından Tamam'ı tıklayın.
- Not: Developer Knowledge API'sini yeni etkinleştirdiyseniz listede görünmesi biraz zaman alabilir. Birkaç dakika bekleyip tekrar deneyin.
- Oluştur'u tıklayın.
Bu Developer Knowledge API anahtarını isteklerinize ekleyin. Örneğin, REST çağrıları, key sorgu parametresi kullanılarak dahil edilmelidir. Örnek için Hızlı başlangıç kılavuzuna bakın.
Dahil edilen belgeler
API'nin hangi belgelerde arama yaptığı hakkında bilgi edinmek için Corpus referansı'na bakın.
Bilinen sınırlamalar
- Markdown Kalitesi: Markdown, kaynak HTML'den oluşturulur. Bazı tutarsızlıklar veya biçimlendirme sorunları olabilir.
- İçerik Kapsamı: Yalnızca Corpus referansındaki herkese açık sayfalar dahil edilir. GitHub, OSS siteleri, blog'lar veya YouTube gibi diğer kaynaklardaki içerikler dahil edilmez.