Google Cloud प्रोजेक्ट से कॉल एपीआई

1. शुरू करने से पहले

यह कोडलैब आपको Google Cloud प्रोजेक्ट बनाने और फिर उस प्रोजेक्ट से Google Cloud API को कॉल करने का तरीका बताता है.

ज़रूरी शर्तें

• Google Cloud Console को नेविगेट करने की सुविधा.

आप इन चीज़ों के बारे में जानेंगे

• Google Cloud प्रोजेक्ट बनाने का तरीका.
• बिलिंग खाता सेट अप करने का तरीका.
• Cloud Shell को सेट अप करने का तरीका.
• एपीआई चालू करने का तरीका.
• एपीआई पासकोड से किसी एपीआई को अनुमति देने का तरीका.
• सेवा खाते से एपीआई को अनुमति देने का तरीका.

आपको इनकी ज़रूरत होगी

• Google खाता, जैसे कि Gmail खाता या Google Workspace खाता.
• मुफ़्त में आज़माने की सुविधा के लिए साइन अप करने के लिए, क्लाउड बिलिंग खाते या क्रेडिट कार्ड का ऐक्सेस.

2. सेट अप करें

इस सेक्शन में, Google Cloud प्रोजेक्ट बनाने, बिलिंग खाता सेट अप करने, और Cloud Shell को सेट अप करने का तरीका बताया गया है.

Google Cloud प्रोजेक्ट बनाना और बिलिंग खाता सेट अप करना

ध्यान दें: अगर आपके पास पहले से कोई Gmail खाता या Google Workspace खाता नहीं है, तो सबसे पहले आपको एक खाता बनाना होगा.

1. Cloud Console में साइन इन करें और कोई प्रोजेक्ट चुनें या बनाएं.

चेतावनी: अगर किसी प्रोजेक्ट का फिर से इस्तेमाल किया जाता है और इस कोडलैब को पूरा किया जाता है, तो कुछ उपयोगकर्ताओं को उस प्रोजेक्ट में संसाधन ऐक्सेस करने की सुविधा दी जा सकती है. ऐसा तब किया जा सकता है, जब इस प्रोजेक्ट को पूरा करने के बाद, वे संसाधन बंद न किए जाएं.

प्रोजेक्ट का नाम फ़ील्ड में दिखाया गया प्रोजेक्ट आईडी याद रखें. यह आईडी, Google Cloud के सभी प्रोजेक्ट के लिए एक यूनीक नाम होता है (ऊपर दिया गया नाम पहले ही किसी दूसरे प्रोजेक्ट के लिए इस्तेमाल किया जा चुका है). बाद में, कोडलैब में इसका इस्तेमाल PROJECT_ID के तौर पर किया जाता है.

ध्यान दें: अगर आपके Gmail खाते का इस्तेमाल किया जाता है, तो डिफ़ॉल्ट जगह को कोई संगठन नहीं पर सेट किया जा सकता है. अगर आपके पास Google Workspace खाता है, तो ऐसी जगह चुनें जो आपके संगठन के लिए सही हो.

2. इसके बाद, Google Cloud के संसाधनों का इस्तेमाल करने के लिए, Cloud Console में बिलिंग की सुविधा चालू करें.

कोडलैब के इस तरीके का इस्तेमाल करने के लिए आपको ज़्यादा पैसे नहीं चुकाने होंगे. हालांकि, इसके लिए आपको साफ़ करें सेक्शन में दिए गए निर्देशों का पालन करना होगा. इससे संसाधनों को बंद करने और कोडलैब के अलावा अन्य खर्चों से बचने में भी मदद मिलेगी. ध्यान दें कि Google Cloud के नए उपयोगकर्ता, 300 डॉलर के मुफ़्त ट्रायल की सुविधा पा सकते हैं.

Cloud Shell सेट अप करना

इस कोडलैब में, Cloud Shell का इस्तेमाल किया जा सकता है. यह एक कमांड-लाइन एनवायरमेंट है, जो Google Cloud में चलता है. Cloud Shell, Debian आधारित वर्चुअल मशीन है. इसमें आपकी ज़रूरत के सभी डेवलपमेंट टूल मौजूद हैं. इसमें पांच जीबी की होम डायरेक्ट्री उपलब्ध होती है. इससे नेटवर्क की परफ़ॉर्मेंस और पुष्टि करने की प्रक्रिया बहुत बेहतर हो जाती है. इसका मतलब है कि इस कोडलैब के लिए, आपके पास सिर्फ़ एक ब्राउज़र होना चाहिए.

Cloud Console से Cloud Shell को चालू करने के लिए:

1. Cloud Shell चालू करें पर क्लिक करें.

प्रावधान करने और एनवायरमेंट से कनेक्ट होने में कुछ समय लग सकता है.

Cloud Shell से कनेक्ट करने के बाद, आपको दिखेगा कि आपकी पुष्टि पहले ही हो चुकी है. साथ ही, यह प्रोजेक्ट पहले से ही आपके PROJECT_ID पर सेट है.

2. क्रेडेंशियल वाले खातों की सूची जनरेट करें:

gcloud auth list

आपको यह आउटपुट दिखेगा:

Credentialed accounts:
 - <MY_ACCOUNT>@<MY_DOMAIN>.com (active)

ध्यान दें: gcloud सीएलआई टूल, Cloud Shell में पहले से इंस्टॉल होता है. इससे आपको Google Cloud के संसाधन बनाने और उन्हें मैनेज करने में मदद मिलती है. ज़्यादा जानकारी के लिए, gcloud टूल की खास जानकारी देखें.

3. अपने प्रोजेक्ट की सूची देखने के लिए, यह निर्देश डालें.

gcloud config list project

आपको यह आउटपुट दिखेगा:

[core]
project = <PROJECT_ID>

अगर किसी वजह से यह प्रोजेक्ट सेट नहीं है, तो प्रोजेक्ट को सेट अप करने के लिए इस निर्देश को चलाएं.

gcloud config set project <PROJECT_ID>

PROJECT_ID वह आईडी है जिसका इस्तेमाल आपने सेटअप चरणों में किया था. इसे Cloud Console के डैशबोर्ड में भी देखा जा सकता है:

Cloud Shell का इस्तेमाल करके, डिफ़ॉल्ट रूप से एनवायरमेंट के कुछ वैरिएबल भी सेट किए जा सकते हैं. ये वैरिएबल, आने वाले समय में कमांड रन करने में काम आ सकते हैं.

4. अपना प्रोजेक्ट आईडी देखने के लिए, यह निर्देश डालें.

echo $GOOGLE_CLOUD_PROJECT

आपको यह आउटपुट दिखेगा:

<PROJECT_ID>

5. आखिर में, डिफ़ॉल्ट ज़ोन और प्रोजेक्ट कॉन्फ़िगरेशन सेट करें.

gcloud config set compute/zone us-central1-f

आपके पास कई तरह के ज़ोन चुनने का विकल्प होता है. ज़्यादा जानकारी के लिए, इलाके और ज़ोन देखें.

ध्यान दें: जब आप अपनी मशीन पर gcloud सीएलआई टूल चलाते हैं, तो कॉन्फ़िगरेशन सेटिंग सभी सेशन में बनी रहती हैं. हालांकि, Cloud Shell में आपको हर नए सेशन या फिर से कनेक्ट करने के लिए, इन सेटिंग को कॉन्फ़िगर करना होगा.

3. किसी प्रोजेक्ट से एपीआई को कॉल करना

यह कोडलैब आपको टेक्स्ट में इकाइयों (जैसे कि लोग, जगहें, और इवेंट) को ढूंढने के लिए उदाहरण एपीआई (Natural Language API) का इस्तेमाल करने का तरीका बताता है. साथ ही, उस टेक्स्ट की भावना (पसंद का स्तर) का अनुमान लगाने का तरीका भी बताता है. आपको यह जानकारी मिलेगी:

• Google Cloud API चालू करें.
• एपीआई पासकोड और सेवा खातों का इस्तेमाल करके, एपीआई के लिए अनुमति पाएं.
• एपीआई को curl और क्लाइंट लाइब्रेरी का इस्तेमाल करके कॉल करें.

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

1. चुनें एपीआई और सेवाएं.

2. स्क्रीन के सबसे ऊपर मौजूद, + एपीआई और सेवाएं चालू करें को चुनें.

3. यहां एपीआई को फ़िल्टर किया जा सकता है और ब्राउज़ किया जा सकता है. इसके अलावा, खोज बॉक्स की मदद से सीधे एपीआई पर भी जाया जा सकता है. Natural Language खोजें और Cloud Natural Language API चुनें.

4. इस एपीआई को आज़माएं पर क्लिक करें.

अगर इस एपीआई को आज़माएं बटन नहीं दिखता है, तो उसे आज़माने के लिए दिए गए किसी एक तरीके पर क्लिक करें.

API (एपीआई) कुंजी बनाएं

Natural Language API को अनुरोध भेजने के लिए, curl का इस्तेमाल किया जाता है. इसलिए, अनुरोध का यूआरएल भेजने के लिए, आपको एपीआई पासकोड जनरेट करना होगा.

1. Cloud Console में, नेविगेशन मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल.

2. क्रेडेंशियल बनाएं पर क्लिक करें. इसके बाद, एपीआई पासकोड चुनें:

3. जनरेट की गई एपीआई कुंजी कॉपी करें. इसके बाद, बंद करें पर क्लिक करें.

एपीआई को कॉल करने के लिए, एपीआई पासकोड का इस्तेमाल करें

1. Cloud Shell की कमांड लाइन में, अपना एपीआई पासकोड एक्सपोर्ट करें.

export API_KEY=<YOUR_API_KEY>

<YOUR_API_KEY> की जगह उस कुंजी का इस्तेमाल करें जिसे आपने पहले जनरेट किया था.

2. Cloud Shell Editor में या Linux एडिटर, जैसे कि Vim या Emacs से एपीआई के लिए अनुरोध बनाएं. पैरामीटर की जानकारी, Method: documents.analyzeEntities पर देखी जा सकती है. आउटपुट को request.json नाम की फ़ाइल में सेव करें:

{
  "document":{
    "type":"PLAIN_TEXT",
    "content":"Google, headquartered in Mountain View (1600 Amphitheatre Pkwy, Mountain View, CA 940430), unveiled the new Android phone for $799 at the Consumer Electronic Show. Sundar Pichai said in his keynote that users love their new Android phones."
  },
  "encodingType":"UTF8"
}

3. अनुरोध जानकारी के साथ एपीआई को कॉल करें.

curl "https://language.googleapis.com/v1/documents:analyzeEntities?key=${API_KEY}" \
  -s -X POST -H "Content-Type: application/json" --data-binary @request.json

4. कमांड को फिर से चलाएं और आउटपुट को किसी फ़ाइल पर रीडायरेक्ट करें और नतीजे की जांच करें. JSON फ़ाइल के आउटपुट की जानकारी मेथड: documents.analyzeEntities में भी दी गई है.
5. request.json फ़ाइल में जिस टेक्स्ट का विश्लेषण करना है उसे बदलने के लिए, content वैल्यू को अपनी पसंद के टेक्स्ट से बदलें.

4. सेवा खाते से अनुमति देना

आम तौर पर, सेवा खातों को एपीआई पासकोड से ज़्यादा प्राथमिकता दी जाती है, क्योंकि इनमें पुष्टि करने और अनुमति देने, दोनों की सुविधा उपलब्ध होती है. सेवा खातों को अपने ऐप्लिकेशन के लिए ईमेल पतों की तरह माना जा सकता है.

1. एपीआई और सेवाएं मेन्यू.
2. क्रेडेंशियल बनाएं चुनें, लेकिन इस बार सेवा खाता चुनें.

3. सेवा खाते का कोई ऐसा नाम दें जिससे इसके मकसद की जानकारी मिलती हो, जैसे कि "Natural Language Service Account". सिस्टम, आईडी का सुझाव देता है. आपके पास ब्यौरा जोड़ने का विकल्प भी होता है. सेवा खातों के बारे में जैसे-जैसे आपको जानकारी मिलती है, वैसे-वैसे प्रोजेक्ट के लिए सेवा खाते का ऐक्सेस दिया जाता है और उपयोगकर्ताओं को सेवा खाते का ऐक्सेस दिया जाता है. फ़िलहाल, सेवा खाता बनाने के लिए हो गया पर क्लिक करें.
4. सेवा खाते में कुंजी का जोड़ा बनाने के लिए, पर क्लिक करके सेवा खाते में बदलाव करें.

आपके सेवा खाते की जानकारी दिखेगी.

5. सेवा खाते का ईमेल पता कॉपी करें और Cloud Shell पर वापस जाएं.
6. Cloud Shell में, अपने सेवा खाते के लिए कुंजी का जोड़ा बनाएं. इसके बाद, इस पर पॉइंट करने के लिए एक एनवायरमेंट वैरिएबल सेट करें:

gcloud iam service-accounts keys create ~/key.json \
  --iam-account <your service account email>
export GOOGLE_APPLICATION_CREDENTIALS="/home/$USER/key.json"

Google Cloud, इस एनवायरमेंट वैरिएबल का इस्तेमाल क्रेडेंशियल ढूंढने के लिए करता है. इसलिए, क्रेडेंशियल को एपीआई कॉल में शामिल करने की ज़रूरत नहीं होती.

7. अब एपीआई को इस निर्देश से कॉल किया जा सकता है:

gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'." 

नतीजा पहले जैसा ही होना चाहिए.

कई एपीआई में इस जानकारी को एक्सट्रैक्ट करने के लिए, बड़ी क्लाइंट लाइब्रेरी होती हैं. क्लाइंट लाइब्रेरी के बारे में ज़्यादा जानने के लिए, Cloud क्लाइंट लाइब्रेरी पर जाएं. उन एपीआई का दस्तावेज़ भी पढ़ें जिनका इस्तेमाल आपने किया है, ताकि यह पता चल सके कि उनके लिए कौनसी क्लाइंट लाइब्रेरी उपलब्ध हैं.

5. व्यवस्थित करें

प्रोजेक्ट के लिए, बिना पाबंदी वाले एपीआई पासकोड का इस्तेमाल करना गलत है. अगर किसी को इसका ऐक्सेस मिल जाता है, तो वह व्यक्ति पुष्टि करने की किसी और ज़रूरत के बिना इसका इस्तेमाल कर सकता है.

इस एपीआई पासकोड को मिटाने के लिए:

1. नेविगेशन मेनू > पर क्लिक करें API और सेवाएं > क्रेडेंशियल.
2. एपीआई पासकोड में जाकर, मिटाने के लिए कोई पासकोड चुनें और फिर Delete पर क्लिक करें.
3. इसी तरह, अपने सेवा खाते की निजी कुंजी के असुरक्षित होने के बारे में चिंता करने के बजाय, सेवा खाते में वह सेवा खाता चुनें जिसे मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.

6. बधाई हो

बधाई हो! आपने Google Cloud प्रोजेक्ट बनाने और प्रोजेक्ट में एपीआई कॉल करने का तरीका सीखा.