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

Cloud Search API का सीधे या SDK टूल के ज़रिए इस्तेमाल करने से पहले, आपको इसका ऐक्सेस कॉन्फ़िगर करना होगा. इस दस्तावेज़ में, 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. नेविगेशन मेन्यू > IAM और एडमिन > सेवा खाते पर क्लिक करें.
3. अपने सेवा खाते का ईमेल पता नोट करें. Cloud Search में डेटा सोर्स जोड़ने के लिए, आपको इसकी ज़रूरत होगी.

5. तीसरे पक्ष के साथ काम करने की सुविधा को शुरू करना

Cloud Search के किसी भी अन्य एपीआई को कॉल करने से पहले, 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 में डेटा कैसे दिखना चाहिए.