Developer Knowledge API, प्रोग्राम के हिसाब से डेवलपर को Google के सार्वजनिक डेवलपर दस्तावेज़ का ऐक्सेस अपने-आप देता रहता है. इससे आपको इस नॉलेज बेस को अपने ऐप्लिकेशन और वर्कफ़्लो में इंटिग्रेट करने में मदद मिलती है.
खास जानकारी
Developer Knowledge API को, Google के डेवलपर दस्तावेज़ों को मशीन से पढ़े जा सकने वाले फ़ॉर्मैट में ऐक्सेस करने के लिए, कैननिकल सोर्स के तौर पर डिज़ाइन किया गया है. यह दस्तावेज़ों को खोजने और उन्हें वापस पाने के साथ-साथ, क्वेरी के जवाब देने के लिए फ़ंक्शन उपलब्ध कराता है:
SearchDocumentChunksक्वेरी के आधार पर, काम के पेज यूआरआई और कॉन्टेंट स्निपेट ढूंढने के लिए.GetDocumentयाBatchGetDocumentsपर क्लिक करके, खोज के नतीजों का पूरा कॉन्टेंट पाएं.AnswerQueryका इस्तेमाल करके, दस्तावेज़ के कॉर्पस के आधार पर क्वेरी के जवाब पाएं.
इसे तुरंत शुरू करने के लिए, क्विकस्टार्ट गाइड पढ़ें.
खोजे जा सकने वाले कॉन्टेंट का कॉर्पस, कॉर्पस रेफ़रंस में दिया गया है.
Developer Knowledge API की मदद से, दस्तावेज़ वाले पेजों को खोजा और वापस पाया जा सकता है. ये पेज, बिना स्ट्रक्चर वाले मार्कडाउन कॉन्टेंट के तौर पर होते हैं.
एपीआई चालू करना
Developer Knowledge API का इस्तेमाल करने के लिए, आपको पहले इसे अपने Google Cloud प्रोजेक्ट के लिए चालू करना होगा.
- Google APIs लाइब्रेरी में, Developer Knowledge API पेज खोलें.
- देख लें कि आपने वह सही प्रोजेक्ट चुना हो जिसमें आपको एपीआई का इस्तेमाल करना है.
- चालू करें पर क्लिक करें. एपीआई को चालू करने या इस्तेमाल करने के लिए, IAM की किसी खास भूमिका की ज़रूरत नहीं होती.
पुष्टि करना
Developer Knowledge API का इस्तेमाल करने के लिए, Developer Knowledge API पासकोड की ज़रूरत होती है. कोई नया खाता बनाने के लिए:
- जिस प्रोजेक्ट के लिए आपने एपीआई चालू किया है उसके Google Cloud Console में, क्रेडेंशियल पेज पर जाएं.
- क्रेडेंशियल बनाएं पर क्लिक करें. इसके बाद, मेन्यू से एपीआई पासकोड चुनें.
- नाम फ़ील्ड में, कुंजी का नाम डालें.
-
एपीआई के इस्तेमाल पर पाबंदियां चुनें ड्रॉप-डाउन पर क्लिक करें. इसके बाद, Developer Knowledge API टाइप करें. नतीजे पर क्लिक करें. इसके बाद, ठीक है पर क्लिक करें.
ध्यान दें:
- अगर आपने अभी-अभी Developer Knowledge API चालू किया है, तो सूची में दिखने में कुछ समय लग सकता है. कुछ मिनट बाद दोबारा कोशिश करें.
-
अगर आपको इस पासकोड का इस्तेमाल, एआई क्लाइंट के सामान्य मॉडल कॉल (उदाहरण के लिए,
GEMINI_API_KEY) के लिए करना है, तो आपको Generative Language API को भी चुनना होगा. ऐसा न करने पर, उन कॉल को ब्लॉक कर दिया जाएगा.
- बनाएं पर क्लिक करें.
अपने अनुरोधों में, Developer Knowledge API का यह पासकोड शामिल करें. उदाहरण के लिए, REST कॉल में key क्वेरी पैरामीटर का इस्तेमाल करके इसे शामिल किया जाना चाहिए. उदाहरण के लिए, क्विकस्टार्ट गाइड देखें.
शामिल किए गए दस्तावेज़
एपीआई किन दस्तावेज़ों को खोजता है, इस बारे में जानने के लिए कॉर्पस रेफ़रंस देखें.
Developer Knowledge API का मकसद, Google डेवलपर से जुड़े नए दस्तावेज़ों का ऐक्सेस देना है. हमारा मकसद, पब्लिश होने के 48 घंटों के अंदर कॉन्टेंट को फिर से इंडेक्स करना है, ताकि नया या अपडेट किया गया दस्तावेज़ दो कामकाजी दिनों के अंदर उपलब्ध हो जाए.सीमाएं
- मार्कडाउन की क्वालिटी: मार्कडाउन, सोर्स एचटीएमएल से जनरेट किया जाता है. ऐसा हो सकता है कि फ़ॉर्मैटिंग से जुड़ी कुछ समस्याएं हों या डेटा में कुछ अंतर हो.
- कॉन्टेंट का दायरा: इसमें सिर्फ़ कॉर्पस रेफ़रंस के सार्वजनिक पेज शामिल होते हैं. इसमें GitHub, ओएसएस साइटों, ब्लॉग या YouTube जैसे अन्य सोर्स का कॉन्टेंट शामिल नहीं है.