इससे पहले कि आप Google Cloud Search API का ऐक्सेस कॉन्फ़िगर करें इस एपीआई का इस्तेमाल सीधे तौर पर या किसी SDK टूल की मदद से करें. यह दस्तावेज़ इसमें, Google Cloud Search API REST API का इस्तेमाल करने के तरीके की जानकारी दी गई है.
1. एपीआई प्रोजेक्ट बनाना
इस एपीआई को चालू करने के लिए, पहले आपको एक Google Cloud प्रोजेक्ट बनाना होगा. यह प्रोजेक्ट में, सभी Google Cloud बनाने, चालू करने, और उनका इस्तेमाल करने का आधार बनाया जाता है इसमें एपीआई मैनेज करना, बिलिंग चालू करना, जोड़ना और सहयोगियों को हटाने और अनुमतियां मैनेज करने की सुविधा मिलती है.
Google Cloud Console खोलें.
पेज में सबसे ऊपर, क्लिक करें
"Google Cloud Console" के दाईं ओर. मौजूदा प्रोजेक्ट की सूची वाला डायलॉग बॉक्स दिखाई देता है.नया प्रोजेक्ट पर क्लिक करें. "नया प्रोजेक्ट" स्क्रीन दिखाई देती है.
प्रोजेक्ट का नाम फ़ील्ड में प्रोजेक्ट का नाम डालें.
(ज़रूरी नहीं) प्रोजेक्ट आईडी में बदलाव करने के लिए, बदलाव करें पर क्लिक करें. प्रोजेक्ट आईडी प्रोजेक्ट बनाने के बाद बदल जाता है, तो वह आईडी जो प्रोजेक्ट के पूरे समय के लिए आपकी ज़रूरतों को पूरा करता है.
प्रोजेक्ट की जगहें ब्राउज़ करने के लिए, ब्राउज़ करें पर क्लिक करें.
अपने प्रोजेक्ट के लिए किसी जगह पर क्लिक करें और चुनें पर क्लिक करें.
बनाएं पर क्लिक करें. कंसोल, डैशबोर्ड पेज पर ले जाता है. प्रोजेक्ट कुछ ही मिनट में बनता है.
प्रोजेक्ट बनाने और उन्हें मैनेज करने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें: प्रोजेक्ट बनाना और मैनेज करना.
2. इस एपीआई को चालू करें
आपको Google Cloud Search API चालू करना होगा और सेवा खाता बनाना होगा, ताकि क्रेडेंशियल डालें.
- यह पक्का करने के लिए कि आप नए प्रोजेक्ट में हैं, आइकॉन है, जो Google Cloud Console बैनर पर जाएं और अपना नया प्रोजेक्ट चुनें.
- एपीआई और सेवाएं चालू करें पर क्लिक करें. "एपीआई लाइब्रेरी में आपका स्वागत है" पेज दिखाई देता है.
- Google Cloud Search API पर जाएं.
- चालू करें पर क्लिक करें. "खास जानकारी" पेज दिखाई देता है.
एपीआई को चालू और बंद करने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें Google Cloud Console में एपीआई मैनेज करना
3. सेवा खाते के क्रेडेंशियल बनाएं
- Google Cloud Console में, बाईं ओर मौजूद नेविगेशन में, क्रेडेंशियल पर क्लिक करें. क्रेडेंशियल पेज दिखेगा.
- क्रेडेंशियल बनाएं ड्रॉप-डाउन सूची से, चुनें सेवा खाता. कॉन्टेंट बनाने "सेवा खाता बनाएं" पेज दिखाई देता है.
- सेवा खाते का नाम फ़ील्ड में कोई नाम डालें.
- (ज़रूरी नहीं) सेवा खाता आईडी में बदलाव करें.
- बनाएं पर क्लिक करें. "सेवा खाते की अनुमतियां" स्क्रीन दिखाई देती है.
- जारी रखें पर क्लिक करें. "उपयोगकर्ताओं को इस सेवा खाते का ऐक्सेस दें" स्क्रीन दिखाई देता है.
- कुंजी बनाएं पर क्लिक करें. इसके बाद, हो गया पर क्लिक करें. "निजी पासकोड, जो कंप्यूटर" डायलॉग बॉक्स दिखाई देता है और आपके कंप्यूटर पर सेव करें.
- बंद करें पर क्लिक करें.
सेवा खातों के बारे में ज़्यादा जानकारी के लिए, इसे देखें सेवा खाते, वेब ऐप्लिकेशन, और इंस्टॉल किए गए ऐप्लिकेशन
4. ईमेल पते की पहचान करें
- Google Cloud Console से, पेज पर सबसे ऊपर, अपना बनाया प्रोजेक्ट चुनें.
- Google Cloud Console के बैनर की बाईं ओर मौजूद, नेविगेशन मेन्यू पर क्लिक करें.
- IAM और एडमिन पर क्लिक करें > सेवा खाते.
- सूची में, "सेवा खाता आईडी" में जाकर, जनरेट किए गए ईमेल को नोट कर लें आपके कॉन्फ़िगर किए गए सेवा खाते की पहचान करता है. यह ईमेल पता का इस्तेमाल Cloud Search में डेटा स्रोत जोड़ते समय किया जाता है.
5. तीसरे पक्ष से सहायता पाने की सुविधा शुरू करें
किसी अन्य Cloud Search एपीआई को कॉल करने से पहले, आपको तीसरे पक्ष के ऐप्लिकेशन या सेवा को शुरू करना होगा में Google Cloud Search का इस्तेमाल करें.
Cloud Search के लिए तीसरे पक्ष की सहायता शुरू करने के लिए:
आपके Cloud Search प्लैटफ़ॉर्म प्रोजेक्ट में, सेवा खाते के क्रेडेंशियल शामिल हैं. हालांकि, तीसरे पक्ष से मिलने वाली सहायता को शुरू करने के लिए, आपको वेब आवेदन के क्रेडेंशियल नहीं दिए हैं. वेब ऐप्लिकेशन बनाने का तरीक़ा जानने के लिए क्रेडेंशियल देखें. इसके लिए, क्रेडेंशियल बनाएं. इस चरण को पूरा करने के बाद, आपके पास क्लाइंट आईडी और क्लाइंट सीक्रेट फ़ाइल होनी चाहिए.
इस्तेमाल की जाने वाली चीज़ें Google का OAuth 2 प्लेग्राउंड ऐक्सेस टोकन पाने के लिए:
- सेटिंग पर क्लिक करें और उपयोगकर्ता के पुष्टि करने के क्रेडेंशियल देखें.
- पहले चरण में दिया गया क्लाइंट आईडी और क्लाइंट सीक्रेट डालें.
- बंद करें पर क्लिक करें.
- स्कोप फ़ील्ड में,
https://www.googleapis.com/auth/cloud_search.settings
टाइप करें और अनुमति दें पर क्लिक करें. OAuth 2 प्लेग्राउंड, ऑथराइज़ेशन कोड दिखाता है. - टोकन के लिए ऑथराइज़ेशन कोड एक्सचेंज करें पर क्लिक करें. टोकन दिखाया जाता है.
Cloud Search के लिए तीसरे पक्ष की सहायता सेवा शुरू करने के लिए, नीचे दिए गए कर्ल का इस्तेमाल करें आदेश.
[YOUR_ACCESS_TOKEN]
को दिए गए टोकन से बदलना न भूलें चरण 2.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 की सहायता टीम से संपर्क करें.
इसकी पुष्टि करने के लिए, 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 }
अगले चरण
यहां दिए गए तरीके का इस्तेमाल किया जा सकता है:
अगर Google Cloud Search का इस्तेमाल, Google से बाहर के डेटा स्टोर करने की जगह के साथ करना है, तो जैसे कि Microsoft® SharePoint®, को डेटा सोर्स बनाना होगा. इस पर निर्देशों के लिए डेटा सोर्स जोड़ना, इसे देखें खोजने के लिए कोई डेटा सोर्स जोड़ें.
डेटा सोर्स सेट अप करने के बाद, ये काम किए जा सकते हैं स्कीमा बनाना और रजिस्टर करना, ताकि Google Cloud Search को रिपॉज़िटरी में मौजूद डेटा को किस तरह दिखाना चाहिए.