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