Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करें

इस एपीआई को सीधे तौर पर या एसडीके के ज़रिए इस्तेमाल करने से पहले, आपको Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करना होगा. इस दस्तावेज़ में, Google Cloud Search API REST API का इस्तेमाल करने के लिए ज़रूरी चरणों के बारे में बताया गया है.

1. एपीआई प्रोजेक्ट बनाना

एपीआई चालू करने के लिए, आपको सबसे पहले Google Cloud प्रोजेक्ट बनाना होगा. यह प्रोजेक्ट, सभी Google Cloud सेवाएं बनाने, चालू करने, और उनका इस्तेमाल करने का आधार बनाता है. इनमें एपीआई मैनेज करना, बिलिंग चालू करना, सहयोगियों को जोड़ना और हटाना, और अनुमतियां मैनेज करना शामिल है.

  1. Google Cloud console खोलें.

  2. पेज पर सबसे ऊपर, "Google Cloud Console" के दाईं ओर मौजूद पर क्लिक करें. आपको मौजूदा प्रोजेक्ट की सूची वाला एक डायलॉग दिखेगा.

  3. नया प्रोजेक्ट पर क्लिक करें. "नया प्रोजेक्ट" स्क्रीन दिखेगी.

  4. प्रोजेक्ट का नाम फ़ील्ड में, प्रोजेक्ट का नाम डालें.

  5. (ज़रूरी नहीं) प्रोजेक्ट आईडी में बदलाव करने के लिए, बदलाव करें पर क्लिक करें. प्रोजेक्ट बनाने के बाद, उसका आईडी नहीं बदला जा सकता. इसलिए, ऐसा आईडी चुनें जो प्रोजेक्ट के पूरे जीवनकाल के दौरान आपकी ज़रूरतों को पूरा करे.

  6. प्रोजेक्ट के लिए जगहें ब्राउज़ करने के लिए, ब्राउज़ करें पर क्लिक करें.

  7. अपने प्रोजेक्ट के लिए कोई जगह चुनें और चुनें पर क्लिक करें.

  8. बनाएं पर क्लिक करें. कंसोल, डैशबोर्ड पेज पर ले जाता है. प्रोजेक्ट कुछ ही मिनटों में बन जाता है.

प्रोजेक्ट बनाने और उन्हें मैनेज करने के बारे में ज़्यादा जानने के लिए, प्रोजेक्ट बनाना और मैनेज करना लेख पढ़ें.

2. एपीआई चालू करना

क्रेडेंशियल पाने के लिए, आपको Google Cloud Search API चालू करना होगा और एक सेवा खाता बनाना होगा.

  1. यह पक्का करने के लिए कि आप नए प्रोजेक्ट पर हैं, Google Cloud Console बैनर के दाईं ओर मौजूद आइकॉन पर क्लिक करें. इसके बाद, अपना नया प्रोजेक्ट चुनें.
  2. एपीआई और सेवाएं चालू करें पर क्लिक करें. "एपीआई लाइब्रेरी में आपका स्वागत है" पेज दिखता है.
  3. Google Cloud Search API पर जाएं.
  4. चालू करें पर क्लिक करें. "खास जानकारी" पेज दिखता है.

एपीआई चालू और बंद करने के बारे में ज़्यादा जानने के लिए, Google Cloud Console में एपीआई मैनेज करना लेख पढ़ें

3. सेवा खाते के क्रेडेंशियल बनाना

  1. Google Cloud Console में, बाईं ओर मौजूद नेविगेशन में क्रेडेंशियल पर क्लिक करें. इसके बाद, क्रेडेंशियल पेज दिखेगा.
  2. क्रेडेंशियल बनाएं ड्रॉप-डाउन सूची से, सेवा खाता चुनें. "सेवा खाता बनाएं" पेज दिखेगा.
  3. सेवा खाते का नाम फ़ील्ड में कोई नाम डालें.
  4. (ज़रूरी नहीं) सेवा खाते के आईडी में बदलाव करें.
  5. बनाएं पर क्लिक करें. "सेवा खाते की अनुमतियां" स्क्रीन दिखती है.
  6. जारी रखें पर क्लिक करें. "उपयोगकर्ताओं को इस सेवा खाते का ऐक्सेस दें" स्क्रीन दिखेगी.
  7. कुंजी बनाएं पर क्लिक करें. इसके बाद, हो गया पर क्लिक करें. "आपके कंप्यूटर पर सेव की गई निजी कुंजी" डायलॉग बॉक्स दिखता है. साथ ही, निजी कुंजी की एक कॉपी आपके कंप्यूटर पर डाउनलोड हो जाती है.
  8. बंद करें पर क्लिक करें.

सेवा खातों के बारे में ज़्यादा जानकारी के लिए, सेवा खाते, वेब ऐप्लिकेशन, और इंस्टॉल किए गए ऐप्लिकेशन पर जाएं

4. ईमेल पते की पहचान करना

  1. Google Cloud Console में जाकर, पेज पर सबसे ऊपर मौजूद, वह प्रोजेक्ट चुनें जिसे आपने बनाया है.
  2. Google Cloud Console बैनर के बाईं ओर मौजूद नेविगेशन मेन्यू पर क्लिक करें.
  3. IAM और एडमिन > सेवा खाते पर क्लिक करें.
  4. सूची में, "सेवा खाता आईडी" में जाकर, जनरेट किए गए उस ईमेल पते को नोट करें जिससे कॉन्फ़िगर किए गए सेवा खाते की पहचान होती है. इस ईमेल पते का इस्तेमाल, Cloud Search में डेटा सोर्स जोड़ते समय किया जाता है.

5. तीसरे पक्ष की सहायता को शुरू करना

किसी अन्य Cloud Search API को कॉल करने से पहले, आपको Google Cloud Search के लिए तीसरे पक्ष की सहायता को शुरू करना होगा.

Cloud Search के लिए, तीसरे पक्ष की सहायता को शुरू करने के लिए:

  1. आपके Cloud Search प्लैटफ़ॉर्म प्रोजेक्ट में सेवा खाते के क्रेडेंशियल मौजूद हैं. हालांकि, तीसरे पक्ष की सहायता को शुरू करने के लिए, आपको वेब ऐप्लिकेशन के क्रेडेंशियल बनाने होंगे. वेब ऐप्लिकेशन के क्रेडेंशियल बनाने के निर्देशों के लिए, क्रेडेंशियल बनाना लेख पढ़ें. यह चरण पूरा करने के बाद, आपके पास क्लाइंट आईडी और क्लाइंट सीक्रेट फ़ाइल होनी चाहिए.

  2. ऐक्सेस टोकन पाने के लिए, Google के OAuth 2 प्लेग्राउंड का इस्तेमाल करें:

    1. सेटिंग पर क्लिक करें और अपने पुष्टि करने वाले क्रेडेंशियल का इस्तेमाल करें को चुनें.
    2. पहले चरण में मिला क्लाइंट आईडी और क्लाइंट सीक्रेट डालें.
    3. बंद करें पर क्लिक करें.
    4. स्कोप फ़ील्ड में, https://www.googleapis.com/auth/cloud_search.settings टाइप करें और अनुमति दें पर क्लिक करें. OAuth 2.0 का प्लेग्राउंड, ऑथराइज़ेशन कोड दिखाता है.
    5. ऑथराइज़ेशन कोड को टोकन के लिए बदलें पर क्लिक करें. एक टोकन वापस कर दिया जाता है.

  3. Cloud Search के लिए तीसरे पक्ष की सहायता को शुरू करने के लिए, यहां दिए गए curl कमांड का इस्तेमाल करें. [YOUR_ACCESS_TOKEN] की जगह, दूसरे चरण में मिला टोकन डालना न भूलें.

    curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

    अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में operation का एक इंस्टेंस शामिल किया जाता है. उदाहरण के लिए:

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
}

    अगर ऐसा नहीं होता है, तो Cloud Search की सहायता टीम से संपर्क करें.

  4. operations.get का इस्तेमाल करके यह पुष्टि करें कि तीसरे पक्ष की सहायता शुरू हो गई है:

    curl \
'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    तीसरे पक्ष की शुरुआत पूरी होने पर, इसमें done फ़ील्ड होता है, जिसे true पर सेट किया जाता है. उदाहरण के लिए:

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
done: true
}

अगले चरण

यहां कुछ ऐसे तरीके दिए गए हैं जिन्हें आज़माया जा सकता है:

  1. अगर आपको Google Cloud Search का इस्तेमाल, Google के बाहर के डेटा रिपॉज़िटरी के साथ करना है, तो आपको डेटा सोर्स बनाना होगा. जैसे, Microsoft® SharePoint®. डेटा सोर्स जोड़ने के निर्देशों के लिए, खोज के लिए डेटा सोर्स जोड़ना लेख पढ़ें.

  2. डेटा सोर्स सेट अप करने के बाद, स्कीमा बनाया और रजिस्टर किया जा सकता है. इससे यह पता चलता है कि Google Cloud Search को रिपॉज़िटरी में डेटा कैसे दिखाना चाहिए.