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

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

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

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

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

किसी अन्य Cloud Search एपीआई को कॉल करने से पहले, आपको 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 टाइप करें और Authorize पर क्लिक करें. OAuth 2 प्लेग्राउंड, ऑथराइज़ेशन कोड दिखाता है.
   5. टोकन के लिए ऑथराइज़ेशन कोड एक्सचेंज करें पर क्लिक करें. टोकन दिखाया जाता है.

3. Cloud Search के लिए तीसरे पक्ष से सहायता देने की सुविधा शुरू करने के लिए, इस कर्ल कमांड का इस्तेमाल करें. [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 को, डेटा स्टोर करने की जगह में डेटा को कैसे दिखाना चाहिए.