Używanie interfejsu Translation API w języku C#

1. Omówienie

Google Cloud Translation API to prosty interfejs programowy do dynamicznego tłumaczenia dowolnych ciągów na dowolny obsługiwany język z wykorzystaniem najnowocześniejszego neuronowego tłumaczenia maszynowego. Może też służyć do wykrywania języka, gdy język źródłowy jest nieznany.

W tym ćwiczeniu w Codelabs dowiesz się, jak używać interfejsu Translation API w języku C#. Dowiesz się, jak wyświetlić listę dostępnych języków, przetłumaczyć tekst, a także jak wykryć język w tekście.

Czego się nauczysz

• Jak używać Cloud Shell
• Jak włączyć interfejs Translation API
• Jak uwierzytelniać żądania do interfejsu API
• Jak zainstalować bibliotekę klienta Google Cloud dla języka C#
• Jak wyświetlić listę dostępnych języków
• Jak tłumaczyć tekst
• Jak rozpoznać język?

Czego potrzebujesz

• Projekt Google Cloud Platform
• przeglądarkę, np. Chrome lub Firefox;
• Znajomość języka C#

Ankieta

2. Konfiguracja i wymagania

Samodzielne konfigurowanie środowiska

1. Zaloguj się w konsoli Google Cloud i utwórz nowy projekt lub wykorzystaj już istniejący. Jeśli nie masz jeszcze konta Gmail ani Google Workspace, musisz je utworzyć.

• Nazwa projektu jest wyświetlaną nazwą uczestników tego projektu. To ciąg znaków, który nie jest używany przez interfejsy API Google. W każdej chwili możesz ją zaktualizować.
• Identyfikator projektu jest unikalny we wszystkich projektach Google Cloud i nie można go zmienić (po jego ustawieniu nie można go zmienić). Cloud Console automatycznie wygeneruje unikalny ciąg znaków. zwykle nieważne, co ona jest. W większości ćwiczeń w Codelabs musisz podać swój identyfikator projektu (zwykle identyfikowany jako PROJECT_ID). Jeśli nie podoba Ci się wygenerowany identyfikator, możesz wygenerować kolejny losowy. Możesz też spróbować własnych sił i sprawdzić, czy jest dostępna. Po wykonaniu tej czynności nie można jej już zmienić. Pozostanie ona przez cały czas trwania projektu.
• Jest jeszcze trzecia wartość, numer projektu, z którego korzystają niektóre interfejsy API. Więcej informacji o wszystkich 3 wartościach znajdziesz w dokumentacji.

2. Następnie musisz włączyć płatności w Cloud Console, aby korzystać z zasobów Cloud/interfejsów API. Ukończenie tego ćwiczenia z programowania nic nie kosztuje. Aby wyłączyć zasoby w celu uniknięcia naliczania opłat po zakończeniu tego samouczka, możesz usunąć utworzone zasoby lub projekt. Nowi użytkownicy Google Cloud mogą skorzystać z programu bezpłatnego okresu próbnego o wartości 300 USD.

Uruchamianie Cloud Shell

Google Cloud można obsługiwać zdalnie z laptopa, ale w ramach tego ćwiczenia z programowania wykorzystasz Google Cloud Shell – środowisko wiersza poleceń działające w chmurze.

W konsoli Google Cloud kliknij ikonę Cloud Shell na górnym pasku narzędzi:

Uzyskanie dostępu do środowiska i połączenie się z nim powinno zająć tylko kilka chwil. Po zakończeniu powinno pojawić się coś takiego:

Ta maszyna wirtualna ma wszystkie potrzebne narzędzia dla programistów. Zawiera stały katalog domowy o pojemności 5 GB i działa w Google Cloud, znacząco zwiększając wydajność sieci i uwierzytelnianie. Wszystkie zadania w ramach tego ćwiczenia z programowania można wykonywać w przeglądarce. Nie musisz niczego instalować.

3. Włączanie interfejsu Translation API

Zanim zaczniesz korzystać z interfejsu Translation API, musisz go włączyć. Interfejs API możesz włączyć, używając w Cloud Shell tego polecenia:

gcloud services enable translate.googleapis.com 

4. Instalowanie biblioteki klienta Google Cloud Translation API dla języka C#

Najpierw utwórz prostą aplikację konsoli w języku C#, której będziesz używać do uruchamiania przykładów interfejsu Translation API.

dotnet new console -n TranslationApiDemo  The template "Console Application" was created successfully. Processing post-creation actions... ... Restore succeeded. 

Następnie przejdź do folderu TranslationApiDemo i dodaj do projektu pakiet 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'. 

Możesz teraz korzystać z interfejsu Translation API.

5. Lista dostępnych języków

W tej sekcji najpierw wymienisz wszystkie języki dostępne w interfejsie Translation API.

Najpierw otwórz edytor kodu w prawym górnym rogu Cloud Shell:

Przejdź do pliku Program.cs znajdującego się w folderze TranslationApiDemo i zastąp kod poniższym kodem:

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}");             }         }     } } 

Poświęć chwilę na zapoznanie się z kodem*.* Pamiętaj, że nazwy języków są podawane w języku angielskim, ale mogą być podane w dowolnym języku.

Uruchom aplikację z powrotem w Cloud Shell. Powinny się wyświetlić te dane wyjściowe:

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

Podsumowanie

W tym kroku udało Ci się wyświetlić listę wszystkich dostępnych języków w Translation API. Pełna lista obsługiwanych języków znajduje się na stronie Obsługa języków.

6. Tłumaczenie tekstu

Za pomocą interfejsu Translate API możesz przetłumaczyć tekst z jednego języka na inny. Tekst jest tłumaczony za pomocą modelu neuronowego tłumaczenia maszynowego (NMT). Jeśli model NMT nie jest obsługiwany w przypadku żądanej pary tłumaczeń językowych, używany jest model tłumaczenia maszynowego opartego na wyrażeniach.

Aby przetłumaczyć tekst, przejdź do pliku Program.cs w folderze TranslationApiDemo i zastąp go tym kodem:

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);         }     } } 

Poświęć chwilę na zapoznanie się z kodem. Tłumaczy tekst „Hello World”. z angielskiego na turecki*.*

Uruchom aplikację z powrotem w Cloud Shell. Powinny się wyświetlić te dane wyjściowe:

dotnet run  Selam Dünya! 

Podsumowanie

W tym kroku udało Ci się przetłumaczyć tekst z angielskiego na turecki za pomocą interfejsu Translation API. Dowiedz się więcej o tłumaczeniu tekstu.

7. Wykryj język

Do wykrywania języka ciągu tekstowego możesz też używać interfejsu Translate API.

Aby wykryć język, przejdź do pliku Program.cs w folderze TranslationApiDemo i zastąp go tym kodem:

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}");         }     } } 

Poświęć chwilę na zapoznanie się z kodem. Wykrywa język tekstu „Selam Dünya!”. co czasem jest tureckim wyrażeniem*.*

Uruchom aplikację z powrotem w Cloud Shell. Powinny się wyświetlić te dane wyjściowe:

dotnet run  Language: tr        Confidence: 1 

Podsumowanie

W tym kroku udało Ci się wykryć język tekstu za pomocą interfejsu Translation API. Dowiedz się więcej o wykrywaniu języka.

8. Gratulacje!

Wiesz już, jak korzystać z interfejsu Translation API w języku C#.

Czyszczenie danych

Oto kroki, które musisz wykonać, aby uniknąć obciążenia konta Google Cloud Platform opłatami za zasoby zużyte podczas krótkiego wprowadzenia:

• Otwórz konsolę Cloud Platform.
• Wybierz projekt, który chcesz wyłączyć, i kliknij „Usuń”. u góry: spowoduje to zaplanowanie usunięcia projektu.

Więcej informacji

• Interfejs Google Cloud Translation API: https://cloud.google.com/translate/docs
• C#/.NET w Google Cloud Platform: https://cloud.google.com/dotnet/
• Klient Google Cloud .NET: https://googlecloudplatform.github.io/google-cloud-dotnet/

Licencja

To zadanie jest licencjonowane na podstawie ogólnej licencji Creative Commons Attribution 2.0.