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

इस एपीआई को सीधे या SDK टूल के ज़रिए इस्तेमाल करने से पहले, आपको 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 में एपीआई मैनेज करना देखें

ध्यान दें: अलग-अलग Cloud Search एपीआई के लिए, अलग-अलग खातों (एडमिन, सेवा, और उपयोगकर्ता) की ज़रूरत होती है. ज़्यादा जानकारी के लिए, कॉल करने का तरीका जानने के लिए रेफ़रंस दस्तावेज़ देखें.

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

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

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

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

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

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

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

ध्यान दें: अगर आपने Cloud Search ट्यूटोरियल लागू कर लिया है, तो इसका मतलब है कि आपने 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 प्लेग्राउंड एक ऑथराइज़ेशन कोड दिखाता है.
   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. अगर आप Microsoft® SharePoint® जैसे किसी गैर-Google डेटा रिपॉज़िटरी के साथ Google Cloud Search का इस्तेमाल करने के बारे में सोच रहे हैं, तो आपको एक डेटा सोर्स बनाना होगा. डेटा सोर्स जोड़ने के निर्देशों के लिए, खोजने के लिए डेटा सोर्स जोड़ना देखें.

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