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

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

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

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

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

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

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

Cloud Search API (एपीआई) चालू करें और क्रेडेंशियल पाने के लिए, सेवा खाता बनाएं.

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

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

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

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

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

ज़्यादा जानकारी के लिए, सेवा खाते देखें.

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

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

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

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

ध्यान दें: अगर आपने Cloud Search ट्यूटोरियल पूरा कर लिया है, तो आपने पहले ही तीसरे पक्ष की सहायता को चालू कर दिया है. इसलिए, इस चरण को स्किप किया जा सकता है.

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

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

3. इस कर्ल कमांड को चलाएं. साथ ही, [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 शामिल होता है. अगर ऐसा नहीं होता है, तो Cloud Search की सहायता टीम से संपर्क करें.

4. शुरू करने की पुष्टि करने के लिए, operations.get का इस्तेमाल करें:

   curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed
   

   जब done true हो जाए, तो समझें कि प्रोसेस पूरी हो गई है.

अगले चरण

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