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 क्वेरी पैरामीटर का इस्तेमाल करके इसे शामिल किया जाना चाहिए. उदाहरण के लिए, क्विकस्टार्ट गाइड देखें.
शामिल किए गए दस्तावेज़
एपीआई किन दस्तावेज़ों को खोजता है, इस बारे में जानने के लिए कॉर्पस रेफ़रंस देखें.
सीमाएं
- मार्कडाउन की क्वालिटी: मार्कडाउन, सोर्स एचटीएमएल से जनरेट होता है. इसमें कुछ अंतर या फ़ॉर्मैटिंग से जुड़ी समस्याएं हो सकती हैं.
- कॉन्टेंट का दायरा: इसमें सिर्फ़ कॉर्पस रेफ़रंस के सार्वजनिक पेज शामिल होते हैं. इसमें GitHub, ओएसएस साइटों, ब्लॉग या YouTube जैसे अन्य सोर्स का कॉन्टेंट शामिल नहीं है.