Package google.developers.knowledge.v1alpha

इंडेक्स

DeveloperKnowledge

Developer Knowledge API, प्रोग्राम के हिसाब से डेवलपर को Google के सार्वजनिक डेवलपर दस्तावेज़ का ऐक्सेस अपने-आप देता रहता है. इससे आपको इस नॉलेज बेस को अपने ऐप्लिकेशन और वर्कफ़्लो में शामिल करने में मदद मिलती है.

इस एपीआई को, Google के डेवलपर के लिए दस्तावेज़ों को मशीन के ज़रिए पढ़े जा सकने वाले फ़ॉर्मैट में ऐक्सेस करने के लिए, कैननिकल सोर्स के तौर पर डिज़ाइन किया गया है.

आम तौर पर, इसका इस्तेमाल इस तरह किया जाता है: सबसे पहले, किसी क्वेरी के आधार पर काम के पेज के यूआरआई खोजने के लिए DeveloperKnowledge.SearchDocumentChunks का इस्तेमाल करें. इसके बाद, सबसे ऊपर दिखने वाले नतीजों का पूरा कॉन्टेंट फ़ेच करने के लिए DeveloperKnowledge.GetDocument या DeveloperKnowledge.BatchGetDocuments का इस्तेमाल करें.

दस्तावेज़ का पूरा कॉन्टेंट, Markdown फ़ॉर्मैट में दिया गया है.

BatchGetDocuments

rpc BatchGetDocuments(BatchGetDocumentsRequest) returns (BatchGetDocumentsResponse)

यह एक साथ कई दस्तावेज़ों को वापस लाता है. हर दस्तावेज़ में पूरा मार्कडाउन कॉन्टेंट होता है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/cloud-platform

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.
GetDocument

rpc GetDocument(GetDocumentRequest) returns (Document)

यह फ़ंक्शन, पूरे मार्कडाउन कॉन्टेंट के साथ एक दस्तावेज़ वापस लाता है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/cloud-platform

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.
SearchDocumentChunks

rpc SearchDocumentChunks(SearchDocumentChunksRequest) returns (SearchDocumentChunksResponse)

यह Google के डेवलपर दस्तावेज़ों में, डेवलपर से जुड़ी जानकारी खोजता है. यह कुकी, उपयोगकर्ता की क्वेरी के आधार पर DocumentChunk दिखाती है. एक ही Document के कई हिस्से हो सकते हैं. पूरे दस्तावेज़ वापस पाने के लिए, DeveloperKnowledge.GetDocument या DeveloperKnowledge.BatchGetDocuments का इस्तेमाल करें. इसके साथ ही, SearchDocumentChunksResponse.results में मिले DocumentChunk.parent का इस्तेमाल करें.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/devprofiles.full_control
  • https://www.googleapis.com/auth/cloud-platform

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.

BatchGetDocumentsRequest

DeveloperKnowledge.BatchGetDocuments के लिए मैसेज का अनुरोध.

फ़ील्ड
names[]

string

ज़रूरी है. इससे उन दस्तावेज़ों के नाम तय किए जाते हैं जिन्हें वापस पाना है. एक बैच में ज़्यादा से ज़्यादा 20 दस्तावेज़ों को वापस लाया जा सकता है. दस्तावेज़, अनुरोध में मौजूद names के क्रम में ही दिखाए जाते हैं.

फ़ॉर्मैट: documents/{uri_without_scheme} उदाहरण: documents/docs.cloud.google.com/storage/docs/creating-buckets

BatchGetDocumentsResponse

DeveloperKnowledge.BatchGetDocuments के लिए जवाब का मैसेज.

फ़ील्ड
documents[]

Document

इसमें मांगे गए दस्तावेज़ शामिल हैं.

दस्तावेज़

दस्तावेज़, Developer Knowledge कॉर्पस से लिए गए कॉन्टेंट के एक हिस्से को दिखाता है.

फ़ील्ड
name

string

आइडेंटिफ़ायर. इसमें दस्तावेज़ का संसाधन नाम होता है. फ़ॉर्मैट: documents/{uri_without_scheme} उदाहरण: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

सिर्फ़ आउटपुट के लिए. कॉन्टेंट का यूआरआई दिखाता है, जैसे कि docs.cloud.google.com/storage/docs/creating-buckets.
content

string

सिर्फ़ आउटपुट के लिए. इसमें दस्तावेज़ का पूरा कॉन्टेंट, मार्कडाउन फ़ॉर्मैट में होता है.
description

string

सिर्फ़ आउटपुट के लिए. दस्तावेज़ के बारे में जानकारी देता है.
title

string

सिर्फ़ आउटपुट के लिए. यह कुकी, दस्तावेज़ का टाइटल उपलब्ध कराती है.

DocumentChunk

DocumentChunk, DeveloperKnowledge कॉर्पस में मौजूद Document से कॉन्टेंट के किसी हिस्से को दिखाता है. पूरे दस्तावेज़ का कॉन्टेंट फ़ेच करने के लिए, parent को DeveloperKnowledge.GetDocument या DeveloperKnowledge.BatchGetDocuments पर पास करें.

फ़ील्ड
parent

string

सिर्फ़ आउटपुट के लिए. इसमें उस दस्तावेज़ का संसाधन नाम होता है जिससे यह हिस्सा लिया गया है. फ़ॉर्मैट: documents/{uri_without_scheme} उदाहरण: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

सिर्फ़ आउटपुट के लिए. इससे दस्तावेज़ में मौजूद इस चंक के आईडी के बारे में पता चलता है. किसी दस्तावेज़ में मौजूद हर चंक का आईडी यूनीक होता है. हालांकि, अलग-अलग दस्तावेज़ों में मौजूद चंक के आईडी एक जैसे हो सकते हैं. चंक आईडी स्थिर नहीं होता और समय के साथ बदल सकता है.
content

string

सिर्फ़ आउटपुट के लिए. इसमें दस्तावेज़ के हिस्से का कॉन्टेंट शामिल होता है.

GetDocumentRequest

DeveloperKnowledge.GetDocument के लिए मैसेज का अनुरोध.

फ़ील्ड
name

string

ज़रूरी है. इससे उस दस्तावेज़ का नाम पता चलता है जिसे वापस पाना है. फ़ॉर्मैट: documents/{uri_without_scheme} उदाहरण: documents/docs.cloud.google.com/storage/docs/creating-buckets

SearchDocumentChunksRequest

DeveloperKnowledge.SearchDocumentChunks के लिए मैसेज का अनुरोध.

फ़ील्ड
query

string

ज़रूरी है. इसमें उपयोगकर्ता की ओर से दी गई रॉ क्वेरी स्ट्रिंग शामिल होती है. जैसे, "Cloud Storage बकेट कैसे बनाएं?".
page_size

int32

ज़रूरी नहीं. इससे यह तय किया जाता है कि ज़्यादा से ज़्यादा कितने नतीजे दिखाए जाएं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा पांच नतीजे दिखेंगे.

इसकी ज़्यादा से ज़्यादा वैल्यू 20 हो सकती है. इससे ज़्यादा वैल्यू डालने पर, INVALID_ARGUMENT गड़बड़ी होगी.
page_token

string

ज़रूरी नहीं. इसमें पेज टोकन होता है, जो पिछले SearchDocumentChunks कॉल से मिला था. अगला पेज पाने के लिए, यह जानकारी दें.

SearchDocumentChunksResponse

DeveloperKnowledge.SearchDocumentChunks के लिए जवाब का मैसेज.

फ़ील्ड
results[]

DocumentChunk

इसमें दी गई क्वेरी के लिए खोज के नतीजे शामिल होते हैं. इस सूची में मौजूद हर DocumentChunk में, खोज क्वेरी से जुड़ा कॉन्टेंट का स्निपेट होता है. पूरे दस्तावेज़ का कॉन्टेंट वापस पाने के लिए, हर नतीजे के DocumentChunk.parent फ़ील्ड का इस्तेमाल DeveloperKnowledge.GetDocument या DeveloperKnowledge.BatchGetDocuments के साथ करें.
next_page_token

string

ज़रूरी नहीं. यह कुकी ऐसा टोकन उपलब्ध कराती है जिसे page_token के तौर पर भेजा जा सकता है, ताकि अगले पेज को वापस पाया जा सके. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होता.