استفاده از Translation API با سی شارپ

1. بررسی اجمالی

Google Cloud Translation API یک رابط برنامه‌ریزی ساده برای ترجمه پویا یک رشته دلخواه به هر زبان پشتیبانی‌شده با استفاده از پیشرفته‌ترین ترجمه ماشین عصبی فراهم می‌کند. همچنین می تواند برای تشخیص زبان در مواردی که زبان مبدأ ناشناخته است استفاده شود.

در این کد لبه، شما بر روی استفاده از API ترجمه با سی شارپ تمرکز خواهید کرد. شما یاد خواهید گرفت که چگونه زبان های موجود را فهرست کنید، متن را ترجمه کنید و همچنین زبان یک متن را تشخیص دهید.

چیزی که یاد خواهید گرفت

• نحوه استفاده از پوسته ابری
• نحوه فعال کردن API ترجمه
• نحوه احراز هویت درخواست های API
• نحوه نصب کتابخانه سرویس گیرنده Google Cloud برای C#
• نحوه فهرست کردن زبان های موجود
• نحوه ترجمه متن
• نحوه تشخیص زبان

آنچه شما نیاز دارید

• یک پروژه Google Cloud Platform
• یک مرورگر، مانند کروم یا فایرفاکس
• آشنایی با سی شارپ

نظرسنجی

چگونه از این آموزش استفاده خواهید کرد؟

فقط از طریق آن را بخوانید آن را بخوانید و تمرینات را کامل کنید

به تجربه خود با سی شارپ چه امتیازی می دهید؟

تازه کار متوسط مسلط

تجربه خود را در استفاده از سرویس‌های پلتفرم ابری Google چگونه ارزیابی می‌کنید؟

تازه کار متوسط مسلط

2. راه اندازی و الزامات

تنظیم محیط خود به خود

1. به Google Cloud Console وارد شوید و یک پروژه جدید ایجاد کنید یا از یک موجود استفاده مجدد کنید. اگر قبلاً یک حساب Gmail یا Google Workspace ندارید، باید یک حساب ایجاد کنید .

• نام پروژه نام نمایشی برای شرکت کنندگان این پروژه است. این یک رشته کاراکتری است که توسط API های Google استفاده نمی شود. همیشه می توانید آن را به روز کنید.
• شناسه پروژه در تمام پروژه‌های Google Cloud منحصربه‌فرد است و تغییرناپذیر است (پس از تنظیم نمی‌توان آن را تغییر داد). Cloud Console به طور خودکار یک رشته منحصر به فرد تولید می کند. معمولاً برای شما مهم نیست که چیست. در اکثر کدها، باید شناسه پروژه خود را ارجاع دهید (معمولاً با نام PROJECT_ID شناخته می شود). اگر شناسه تولید شده را دوست ندارید، ممکن است یک شناسه تصادفی دیگر ایجاد کنید. از طرف دیگر، می‌توانید خودتان را امتحان کنید، و ببینید آیا در دسترس است یا خیر. پس از این مرحله نمی توان آن را تغییر داد و در طول مدت پروژه باقی می ماند.
• برای اطلاع شما، یک مقدار سوم وجود دارد، یک شماره پروژه ، که برخی از API ها از آن استفاده می کنند. در مورد هر سه این مقادیر در مستندات بیشتر بیاموزید.

احتیاط: شناسه پروژه در سطح جهانی منحصر به فرد است و پس از انتخاب شما توسط شخص دیگری نمی توان از آن استفاده کرد. شما تنها کاربر آن شناسه هستید. حتی اگر پروژه ای حذف شود، ID نمی تواند دوباره استفاده شود

توجه: اگر از یک حساب جیمیل استفاده می‌کنید، می‌توانید مکان پیش‌فرض را روی بدون سازمان بگذارید. اگر از حساب Google Workspace استفاده می کنید، مکانی را انتخاب کنید که برای سازمان شما منطقی باشد.

2. در مرحله بعد، برای استفاده از منابع Cloud/APIها باید صورتحساب را در کنسول Cloud فعال کنید . اجرا کردن از طریق این کد لبه هزینه زیادی نخواهد داشت. برای خاموش کردن منابع برای جلوگیری از تحمیل صورت‌حساب فراتر از این آموزش، می‌توانید منابعی را که ایجاد کرده‌اید حذف کنید یا پروژه را حذف کنید. کاربران جدید Google Cloud واجد شرایط برنامه آزمایشی رایگان 300 دلاری هستند.

Cloud Shell را راه اندازی کنید

در حالی که Google Cloud را می توان از راه دور از لپ تاپ شما کار کرد، در این کد لبه از Google Cloud Shell استفاده خواهید کرد، یک محیط خط فرمان که در Cloud اجرا می شود.

از Google Cloud Console ، روی نماد Cloud Shell در نوار ابزار بالا سمت راست کلیک کنید:

تهیه و اتصال به محیط فقط چند لحظه طول می کشد. وقتی تمام شد، باید چیزی شبیه به این را ببینید:

این ماشین مجازی با تمام ابزارهای توسعه که شما نیاز دارید بارگذاری شده است. این یک فهرست اصلی 5 گیگابایتی دائمی را ارائه می دهد و در Google Cloud اجرا می شود و عملکرد و احراز هویت شبکه را تا حد زیادی افزایش می دهد. تمام کارهای شما در این کد لبه را می توان در یک مرورگر انجام داد. شما نیازی به نصب چیزی ندارید.

3. Translation API را فعال کنید

قبل از اینکه بتوانید از API ترجمه استفاده کنید، باید API را فعال کنید. می توانید API را با استفاده از دستور زیر در Cloud Shell فعال کنید:

gcloud services enable translate.googleapis.com

توجه: اگر این دستور ERROR دارد، بررسی کنید که شناسه پروژه فعلی با ID پروژه کد لبه شما مطابقت داشته باشد.

از دستور زیر برای یافتن شناسه پروژه فعلی مورد استفاده توسط Cloud Shell استفاده کنید:

gcloud info | grep "project"

اگر شناسه پروژه درست نیست، از دستور زیر برای استفاده از شناسه پروژه درست استفاده کنید:

gcloud config set project <PROJECT_ID>

<PROJECT_ID> با شناسه پروژه صحیح جایگزین کنید.

4. کتابخانه سرویس گیرنده Google Cloud Translation API را برای C# نصب کنید

ابتدا یک برنامه کنسول 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. فهرست زبان های موجود

در این بخش، ابتدا تمام زبان های موجود در Translation API را فهرست می کنید.

ابتدا ویرایشگر کد را از سمت راست بالای Cloud Shell باز کنید:

به فایل Program.cs داخل پوشه TranslationApiDemo بروید و کد زیر را جایگزین کنید:

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

توجه: اگر این کد C# برای شما کار نمی کند، دستورالعمل هایی را که در مرحله درخواست های Authenticate API انجام داده اید تأیید کنید.

با استفاده از دستور زیر برای تأیید مقدار متغیر محیطی GOOGLE_APPLICATION_CREDENTIALS :

echo GOOGLE_APPLICATION_CREDENTIALS

باید مقدار " ~/key.json ".

اگر این کار را کرد، سپس بررسی کنید که یک حساب سرویس ایجاد شده و در " ~/key.json " قرار دارد با استفاده از:

cat "~/key.json"

شما باید چیزی شبیه به:

{

"type": "service_account",

"project_id": "PROJECT_ID",

"private_key_id": "ff31939192529e07f42e4535fb20bb029def1276",

"Private_key":...

اگر این کار را نکردید، دوباره به مرحله درخواست‌های API Authenticate مراجعه کنید.

خلاصه

در این مرحله، می‌توانید تمام زبان‌های موجود را در Translation API فهرست کنید. می توانید لیست کامل زبان های پشتیبانی شده را در صفحه پشتیبانی زبان بیابید.

6. متن را ترجمه کنید

می توانید از Translate API برای ترجمه یک متن به زبانی به زبان دیگر استفاده کنید. متن با استفاده از مدل ترجمه ماشین عصبی (NMT) ترجمه می شود. اگر مدل NMT برای جفت ترجمه زبان درخواستی پشتیبانی نمی شود، از مدل ترجمه ماشینی مبتنی بر عبارت (PBMT) استفاده می شود.

برای ترجمه متن، به فایل Program.cs داخل پوشه TranslationApiDemo بروید و کد زیر را جایگزین کنید:

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 برای تشخیص زبان یک رشته متنی نیز استفاده کنید.

برای شناسایی زبان، به فایل Program.cs داخل پوشه TranslationApiDemo بروید و کد زیر را جایگزین کنید:

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. تبریک!

شما یاد گرفتید که چگونه از API ترجمه با استفاده از سی شارپ استفاده کنید!

پاک کن

برای جلوگیری از تحمیل هزینه به حساب Google Cloud Platform برای منابع استفاده شده در این شروع سریع:

• به کنسول Cloud Platform بروید.
• پروژه‌ای را که می‌خواهید تعطیل کنید انتخاب کنید، سپس روی «حذف» در بالا کلیک کنید: با این کار، پروژه برای حذف برنامه‌ریزی می‌شود.

بیشتر بدانید

• Google Cloud Translation API: https://cloud.google.com/translate/docs
• C#/.NET در Google Cloud Platform: https://cloud.google.com/dotnet/
• سرویس گیرنده Google Cloud.NET: https://googlecloudplatform.github.io/google-cloud-dotnet/

مجوز

این اثر تحت مجوز Creative Commons Attribution 2.0 Generic مجوز دارد.