שימוש ב-Translate API עם C#

1. סקירה כללית

‫Google Cloud Translation API מספק ממשק פרוגרמטי פשוט לתרגום דינמי של מחרוזת שרירותית לכל שפה נתמכת באמצעות תרגום מכונה עצבי מתקדם. אפשר להשתמש בו גם כדי לזהות שפה במקרים שבהם שפת המקור לא ידועה.

ב-Codelab הזה נתמקד בשימוש ב-Translation API עם C#. תלמדו איך לראות את רשימת השפות הזמינות, לתרגם טקסט וגם לזהות את השפה של טקסט נתון.

מה תלמדו

איך משתמשים ב-Cloud Shell
איך מפעילים את Translation API
איך מאמתים בקשות API
איך מתקינים את ספריית הלקוח של Google Cloud ל-C#‎
איך מציגים רשימה של שפות זמינות
כיצד לתרגם טקסט
איך לזהות שפה

מה תצטרכו

פרויקט ב-Google Cloud Platform
דפדפן, כמו Chrome או Firefox
היכרות עם C#‎

סקר

איך תשתמשו במדריך הזה?

רק לקרוא

לקרוא ולבצע את התרגילים

איך היית מדרג את חוויית השימוש שלך ב-C#‎?

מתחילים

ביניים

מומחים

איזה דירוג מגיע לדעתך לחוויית השימוש שלך בשירותים של Google Cloud Platform?

מתחילים

ביניים

מומחים

‫2. הגדרה ודרישות

הגדרת סביבה בקצב אישי

נכנסים ל-מסוף Google Cloud ויוצרים פרויקט חדש או משתמשים בפרויקט קיים. אם עדיין אין לכם חשבון Gmail או Google Workspace, אתם צריכים ליצור חשבון.

שם הפרויקט הוא השם המוצג של הפרויקט הזה למשתתפים. זו מחרוזת תווים שלא נמצאת בשימוש ב-Google APIs. תמיד אפשר לעדכן את המיקום.
מזהה הפרויקט הוא ייחודי לכל הפרויקטים ב-Google Cloud ואי אפשר לשנות אותו אחרי שהוא מוגדר. מסוף Cloud יוצר באופן אוטומטי מחרוזת ייחודית, ובדרך כלל לא צריך לדעת מה היא. ברוב ה-Codelabs, תצטרכו להפנות למזהה הפרויקט (בדרך כלל מסומן כ-PROJECT_ID). אם אתם לא אוהבים את המזהה שנוצר, אתם יכולים ליצור מזהה אקראי אחר. אפשר גם לנסות שם משתמש משלכם ולבדוק אם הוא זמין. אי אפשר לשנות את ההגדרה הזו אחרי השלב הזה, והיא תישאר לאורך הפרויקט.
לידיעתכם, יש ערך שלישי, מספר פרויקט, שחלק מממשקי ה-API משתמשים בו. במאמרי העזרה מפורט מידע נוסף על שלושת הערכים האלה.

בשלב הבא, תצטרכו להפעיל את החיוב במסוף Cloud כדי להשתמש במשאבי Cloud או בממשקי API של Cloud. השלמת ה-codelab הזה לא תעלה לכם הרבה, אם בכלל. כדי להשבית את המשאבים ולמנוע חיובים נוספים אחרי שתסיימו את המדריך הזה, תוכלו למחוק את המשאבים שיצרתם או למחוק את הפרויקט. משתמשים חדשים ב-Google Cloud זכאים לתוכנית תקופת ניסיון בחינם בשווי 300$.

מפעילים את Cloud Shell

אפשר להפעיל את Google Cloud מרחוק מהמחשב הנייד, אבל ב-codelab הזה תשתמשו ב-Google Cloud Shell, סביבת שורת פקודה שפועלת בענן.

ב-מסוף Google Cloud, לוחצים על סמל Cloud Shell בסרגל הכלים שבפינה הימנית העליונה:

יחלפו כמה רגעים עד שההקצאה והחיבור לסביבת העבודה יושלמו. בסיום התהליך, אמור להופיע משהו כזה:

המכונה הווירטואלית הזו כוללת את כל הכלים שדרושים למפתחים. יש בה ספריית בית בנפח מתמיד של 5GB והיא פועלת ב-Google Cloud, מה שמשפר מאוד את הביצועים והאימות ברשת. אפשר לבצע את כל העבודה ב-codelab הזה בדפדפן. לא צריך להתקין שום דבר.

‫3. הפעלת Translation API

לפני שמתחילים להשתמש ב-Translation API, צריך להפעיל אותו. כדי להפעיל את ה-API, משתמשים בפקודה הבאה ב-Cloud Shell:

gcloud services enable translate.googleapis.com

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 ומוסיפים את חבילת NuGet Google.Cloud.Translation.V2 לפרויקט:

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

סיכום

בשלב הזה, יכולתם לראות רשימה של כל השפות שזמינות ב-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. מעולה!

למדתם איך להשתמש ב-Translation API באמצעות C#.

הסרת המשאבים

כדי להימנע מחיובים בחשבון Google Cloud Platform על המשאבים שבהם השתמשתם במדריך למתחילים הזה:

עוברים אל Cloud Platform Console.
בוחרים את הפרויקט שרוצים לסגור ולוחצים על 'מחיקה' בחלק העליון. הפעולה הזו מתזמנת את הפרויקט למחיקה.

מידע נוסף

‫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 שמותנה בייחוס 2.0 כללי.