C# के साथ Translation API का इस्तेमाल करना

1. खास जानकारी

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

इस कोडलैब में, C# के साथ Translation API का इस्तेमाल करने पर फ़ोकस किया जाएगा. आपको उपलब्ध भाषाओं की सूची बनाने, टेक्स्ट का अनुवाद करने, और दिए गए टेक्स्ट की भाषा का पता लगाने का तरीका बताया जाएगा.

आपको क्या सीखने को मिलेगा

  • Cloud Shell का इस्तेमाल कैसे करें
  • Translation API को चालू करने का तरीका
  • एपीआई अनुरोधों की पुष्टि करने का तरीका
  • C# के लिए Google Cloud क्लाइंट लाइब्रेरी इंस्टॉल करने का तरीका
  • उपलब्ध भाषाओं की सूची बनाने का तरीका
  • पाठ का अनुवाद कैसे करें
  • भाषा का पता कैसे लगाया जाता है

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

  • Google Cloud Platform प्रोजेक्ट
  • कोई ब्राउज़र, जैसे कि Chrome या Firefox
  • C# का इस्तेमाल करने की जानकारी

सर्वे

इस ट्यूटोरियल का इस्तेमाल कैसे किया जाएगा?

सिर्फ़ इसे पढ़ें इसे पढ़ें और एक्सरसाइज़ पूरी करें

C# के साथ अपने अनुभव को आप क्या रेटिंग देंगे?

शुरुआती सामान्य एडवांस

Google Cloud Platform की सेवाओं को इस्तेमाल करने के अपने अनुभव को आप क्या रेटिंग देंगे?

शुरुआती सामान्य एडवांस

2. सेटअप और ज़रूरी शर्तें

अपने हिसाब से एनवायरमेंट सेट अप करना

  1. Google Cloud Console में साइन इन करें और नया प्रोजेक्ट बनाएं या किसी मौजूदा प्रोजेक्ट का फिर से इस्तेमाल करें. अगर आपके पास पहले से कोई Gmail या Google Workspace खाता नहीं है, तो आपको एक खाता बनाना होगा.

295004821bab6a87.png

37d264871000675d.png

96d86d3d5655cdbe.png

  • प्रोजेक्ट का नाम, इस प्रोजेक्ट में हिस्सा लेने वाले लोगों के लिए डिसप्ले नेम होता है. यह एक वर्ण स्ट्रिंग है, जिसका इस्तेमाल Google API नहीं करते. इसे कभी भी अपडेट किया जा सकता है.
  • प्रोजेक्ट आईडी, सभी Google Cloud प्रोजेक्ट के लिए यूनीक होता है. साथ ही, इसे बदला नहीं जा सकता. Cloud Console, यूनीक स्ट्रिंग को अपने-आप जनरेट करता है. आम तौर पर, आपको इससे कोई फ़र्क़ नहीं पड़ता कि यह क्या है. ज़्यादातर कोडलैब में, आपको अपने प्रोजेक्ट आईडी (आम तौर पर PROJECT_ID के तौर पर पहचाना जाता है) का रेफ़रंस देना होगा. अगर आपको जनरेट किया गया आईडी पसंद नहीं है, तो कोई दूसरा रैंडम आईडी जनरेट किया जा सकता है. इसके अलावा, आपके पास अपना नाम आज़माने का विकल्प भी है. इससे आपको पता चलेगा कि वह नाम उपलब्ध है या नहीं. इस चरण के बाद, इसे बदला नहीं जा सकता. यह प्रोजेक्ट की अवधि तक बना रहता है.
  • आपकी जानकारी के लिए बता दें कि एक तीसरी वैल्यू भी होती है, जिसे प्रोजेक्ट नंबर कहते हैं. इसका इस्तेमाल कुछ एपीआई करते हैं. इन तीनों वैल्यू के बारे में ज़्यादा जानने के लिए, दस्तावेज़ देखें.
  1. इसके बाद, आपको Cloud Console में बिलिंग चालू करनी होगी, ताकि Cloud संसाधनों/एपीआई का इस्तेमाल किया जा सके. इस कोडलैब को पूरा करने में ज़्यादा समय नहीं लगेगा. इस ट्यूटोरियल के बाद बिलिंग से बचने के लिए, संसाधनों को बंद किया जा सकता है. इसके लिए, बनाए गए संसाधनों को मिटाएं या प्रोजेक्ट को मिटाएं. Google Cloud के नए उपयोगकर्ताओं को, 300 डॉलर का क्रेडिट मिलेगा. वे इसे मुफ़्त में आज़मा सकते हैं.

Cloud Shell शुरू करें

Google Cloud को अपने लैपटॉप से रिमोटली ऐक्सेस किया जा सकता है. हालांकि, इस कोडलैब में Google Cloud Shell का इस्तेमाल किया जाएगा. यह क्लाउड में चलने वाला कमांड लाइन एनवायरमेंट है.

Google Cloud Console में, सबसे ऊपर दाएं कोने में मौजूद टूलबार पर, Cloud Shell आइकॉन पर क्लिक करें:

84688aa223b1c3a2.png

इसे चालू करने और एनवायरमेंट से कनेक्ट करने में सिर्फ़ कुछ सेकंड लगेंगे. यह प्रोसेस पूरी होने के बाद, आपको कुछ ऐसा दिखेगा:

320e18fedb7fbe0.png

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

3. Translation API चालू करना

Translation API का इस्तेमाल शुरू करने से पहले, आपको इसे चालू करना होगा. Cloud Shell में यह कमांड इस्तेमाल करके, एपीआई को चालू किया जा सकता है:

gcloud services enable translate.googleapis.com

4. C# के लिए, Google Cloud Translation API की क्लाइंट लाइब्रेरी इंस्टॉल करना

सबसे पहले, एक सामान्य C# कंसोल ऐप्लिकेशन बनाएं. इसका इस्तेमाल, Translation API के सैंपल चलाने के लिए किया जाएगा.

dotnet new console -n TranslationApiDemo

The template "Console Application" was created successfully.
Processing post-creation actions...
...
Restore succeeded.

इसके बाद, TranslationApiDemo फ़ोल्डर पर जाएं और प्रोजेक्ट में Google.Cloud.Translation.V2 NuGet पैकेज जोड़ें:

cd TranslationApiDemo/
dotnet add package Google.Cloud.Translation.V2

info : Adding PackageReference for package 'Google.Cloud.Translation.V2' into project '/home/atameldev/TranslationDemo/TranslationDemo.csproj'.
log  : Restoring packages for /home/atameldev/TranslationDemo/TranslationDemo.csproj...
...
info : PackageReference for package 'Google.Cloud.Translation.V2' version '1.0.0' added to file '/home/atameldev/TranslationDemo/TranslationDemo.csproj'.

अब Translation API का इस्तेमाल किया जा सकता है!

5. List Available Languages

इस सेक्शन में, Translation API में उपलब्ध सभी भाषाओं की सूची बनाएं.

सबसे पहले, Cloud Shell में सबसे ऊपर दाईं ओर मौजूद कोड एडिटर खोलें:

fd3fc1303e63572.png

TranslationApiDemo फ़ोल्डर में मौजूद Program.cs फ़ाइल पर जाएं और कोड की जगह यह कोड डालें:

using System;
using Google.Cloud.Translation.V2;

namespace TranslationApiDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            var client = TranslationClient.Create();
            foreach (var language in client.ListLanguages(LanguageCodes.English))
            {
                Console.WriteLine($"{language.Code}\t{language.Name}");
            }
        }
    }
}

कोड*.* को समझने के लिए एक या दो मिनट का समय लें. ध्यान दें कि हम भाषा के नाम अंग्रेज़ी में दिखा रहे हैं. हालांकि, इसे किसी भी भाषा में दिखाया जा सकता है.

Cloud Shell में वापस जाकर, ऐप्लिकेशन चलाएं. आपको यह आउटपुट दिखेगा:

dotnet run

af        Afrikaans
sq        Albanian
am        Amharic
ar        Arabic
hy        Armenian
az        Azerbaijani
eu        Basque
be        Belarusian
...
yi        Yiddish
yo        Yoruba
zu        Zulu

खास जानकारी

इस चरण में, Translation API में उपलब्ध सभी भाषाओं की सूची बनाई जा सकती है. भाषा से जुड़ी सहायता पेज पर, आपको उन भाषाओं की पूरी सूची मिल सकती है जिनमें यह सुविधा उपलब्ध है.

6. टेक्स्ट का अनुवाद करें

Translate API का इस्तेमाल करके, किसी टेक्स्ट का एक भाषा से दूसरी भाषा में अनुवाद किया जा सकता है. टेक्स्ट का अनुवाद, न्यूरल मशीन ट्रांसलेशन (एनएमटी) मॉडल का इस्तेमाल करके किया जाता है. अगर अनुरोध की गई भाषा के लिए, NMT मॉडल काम नहीं करता है, तो फ़्रेज़-आधारित मशीन ट्रांसलेशन (पीबीएमटी) मॉडल का इस्तेमाल किया जाता है.

टेक्स्ट का अनुवाद करने के लिए, TranslationApiDemo फ़ोल्डर में मौजूद Program.cs फ़ाइल पर जाएं और कोड को इससे बदलें:

using System;
using Google.Cloud.Translation.V2;

namespace TranslationApiDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            var client = TranslationClient.Create();
            var text = "Hello World!";
            var response = client.TranslateText(text, LanguageCodes.Turkish, LanguageCodes.English);
            Console.WriteLine(response.TranslatedText);
        }
    }
}

कोड को समझने के लिए, एक या दो मिनट का समय लें. यह फ़ंक्शन, "Hello World" टेक्स्ट का अंग्रेज़ी से तुर्क भाषा में अनुवाद करता है*.*

Cloud Shell में वापस जाकर, ऐप्लिकेशन चलाएं. आपको यह आउटपुट दिखेगा:

dotnet run

Selam Dünya!

खास जानकारी

इस चरण में, आपने Translation API का इस्तेमाल करके, अंग्रेज़ी से तुर्क भाषा में टेक्स्ट का अनुवाद किया. टेक्स्ट का अनुवाद करने के बारे में ज़्यादा जानें.

7. भाषा का पता लगाएं

Translate API का इस्तेमाल करके, किसी टेक्स्ट स्ट्रिंग की भाषा का पता भी लगाया जा सकता है.

भाषा का पता लगाने के लिए, TranslationApiDemo फ़ोल्डर में मौजूद Program.cs फ़ाइल पर जाएं और कोड को इससे बदलें:

using System;
using Google.Cloud.Translation.V2;

namespace TranslationApiDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            var client = TranslationClient.Create();
            var text = "Selam Dünya!";
            var detection = client.DetectLanguage(text);
            Console.WriteLine($"Language: {detection.Language}\tConfidence: {detection.Confidence}");
        }
    }
}

कोड को समझने के लिए, एक या दो मिनट का समय लें. यह "Selam Dünya!" टेक्स्ट की भाषा का पता लगाता है. यह तुर्किये भाषा का एक वाक्यांश है*.*

Cloud Shell में वापस जाकर, ऐप्लिकेशन चलाएं. आपको यह आउटपुट दिखेगा:

dotnet run

Language: tr        Confidence: 1

खास जानकारी

इस चरण में, आपने Translation API का इस्तेमाल करके किसी टेक्स्ट की भाषा का पता लगाया. भाषा का पता लगाने के बारे में ज़्यादा जानें.

8. बधाई हो!

आपने C# का इस्तेमाल करके, Translation API का इस्तेमाल करने का तरीका सीखा!

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

इस क्विकस्टार्ट में इस्तेमाल की गई संसाधनों के लिए, अपने Google Cloud Platform खाते से शुल्क न लिए जाने के लिए:

  • Cloud Platform Console पर जाएं.
  • वह प्रोजेक्ट चुनें जिसे बंद करना है. इसके बाद, सबसे ऊपर मौजूद ‘मिटाएं' पर क्लिक करें: इससे प्रोजेक्ट को मिटाने के लिए शेड्यूल कर दिया जाता है.

ज़्यादा जानें

लाइसेंस

इस काम के लिए, Creative Commons एट्रिब्यूशन 2.0 जेनेरिक लाइसेंस के तहत लाइसेंस मिला है.