Translation API mit C# verwenden

1. Übersicht

Die Google Cloud Translation API bietet eine einfache programmatische Schnittstelle für die dynamische Übersetzung beliebiger Strings in eine unterstützte Sprache mithilfe modernster neuronaler maschineller Übersetzung. Sie kann auch verwendet werden, um die Sprache zu erkennen, wenn die Ausgangssprache unbekannt ist.

In diesem Codelab konzentrieren Sie sich auf die Verwendung der Translation API mit C#. Sie erfahren, wie Sie verfügbare Sprachen auflisten, Text übersetzen und die Sprache eines bestimmten Texts erkennen.

Lerninhalte

Cloud Shell verwenden
Translation API aktivieren
API-Anfragen authentifizieren
Google Cloud-Clientbibliothek für C# installieren
Verfügbare Sprachen auflisten
Text übersetzen
Sprache erkennen

Voraussetzungen

Google Cloud Platform-Projekt
Browser, z. B. Chrome oder Firefox
Vertrautheit mit C#

Umfrage

Wie werden Sie diese Anleitung verwenden?

Nur lesen

Lesen und Übungen durchführen

Wie würden Sie Ihre Erfahrung mit C# bewerten?

Anfänger

Mittelstufe

Fortgeschrittene

Wie würden Sie Ihre Erfahrungen mit der Verwendung von Google Cloud Platform-Diensten bewerten?

Anfänger

Mittelstufe

Fortgeschritten

2. Einrichtung und Anforderungen

Umgebung zum selbstbestimmten Lernen einrichten

Melden Sie sich in der Google Cloud Console an und erstellen Sie ein neues Projekt oder verwenden Sie ein vorhandenes. Wenn Sie noch kein Gmail- oder Google Workspace-Konto haben, müssen Sie eines erstellen.

Der Projektname ist der Anzeigename für die Teilnehmer dieses Projekts. Es handelt sich um einen String, der nicht von Google APIs verwendet wird. Sie können sie jederzeit aktualisieren.
Die Projekt-ID ist für alle Google Cloud-Projekte eindeutig und unveränderlich (kann nach dem Festlegen nicht mehr geändert werden). In der Cloud Console wird automatisch ein eindeutiger String generiert. Normalerweise ist es nicht wichtig, wie dieser String aussieht. In den meisten Codelabs müssen Sie auf Ihre Projekt-ID verweisen (in der Regel als PROJECT_ID angegeben). Wenn Ihnen die generierte ID nicht gefällt, können Sie eine andere zufällige ID generieren. Alternativ können Sie es mit einem eigenen Namen versuchen und sehen, ob er verfügbar ist. Sie kann nach diesem Schritt nicht mehr geändert werden und bleibt für die Dauer des Projekts bestehen.
Zur Information: Es gibt einen dritten Wert, die Projektnummer, die von einigen APIs verwendet wird. Weitere Informationen zu diesen drei Werten

Als Nächstes müssen Sie die Abrechnung in der Cloud Console aktivieren, um Cloud-Ressourcen/-APIs zu verwenden. Die Durchführung dieses Codelabs kostet wenig oder gar nichts. Wenn Sie Ressourcen herunterfahren möchten, um Kosten zu vermeiden, die über diese Anleitung hinausgehen, können Sie die erstellten Ressourcen oder das Projekt löschen. Neue Google Cloud-Nutzer können am kostenlosen Testzeitraum mit einem Guthaben von 300$ teilnehmen.

Cloud Shell starten

Während Sie Google Cloud von Ihrem Laptop aus per Fernzugriff nutzen können, wird in diesem Codelab Google Cloud Shell verwendet, eine Befehlszeilenumgebung, die in der Cloud ausgeführt wird.

Klicken Sie in der Google Cloud Console rechts oben in der Symbolleiste auf das Cloud Shell-Symbol:

Die Bereitstellung und Verbindung mit der Umgebung sollte nur wenige Augenblicke dauern. Anschließend sehen Sie in etwa Folgendes:

Diese virtuelle Maschine verfügt über sämtliche Entwicklertools, die Sie benötigen. Sie bietet ein Basisverzeichnis mit 5 GB nichtflüchtigem Speicher und läuft in Google Cloud, was die Netzwerkleistung und Authentifizierung erheblich verbessert. Alle Aufgaben in diesem Codelab können in einem Browser ausgeführt werden. Sie müssen nichts installieren.

3. Translation API aktivieren

Bevor Sie die Translation API verwenden können, müssen Sie sie aktivieren. Sie können die API mit dem folgenden Befehl in Cloud Shell aktivieren:

gcloud services enable translate.googleapis.com

4. Google Cloud Translation API-Clientbibliothek für C# installieren

Erstellen Sie zuerst eine einfache C#-Konsolenanwendung, mit der Sie Translation API-Beispiele ausführen.

dotnet new console -n TranslationApiDemo

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

Rufen Sie als Nächstes den Ordner TranslationApiDemo auf und fügen Sie dem Projekt das NuGet-Paket Google.Cloud.Translation.V2 hinzu:

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'.

Jetzt können Sie die Translation API verwenden.

5. Verfügbare Sprachen auflisten

In diesem Abschnitt listen Sie zuerst alle in der Translation API verfügbaren Sprachen auf.

Öffnen Sie zuerst den Code-Editor rechts oben in Cloud Shell:

Rufen Sie die Datei Program.cs im Ordner TranslationApiDemo auf und ersetzen Sie den Code durch Folgendes:

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

Nehmen Sie sich ein oder zwei Minuten Zeit, um sich den Code anzusehen.* Die Namen der Sprachen werden auf Englisch aufgeführt, können aber in jeder Sprache angegeben werden.

Führen Sie die App wieder in Cloud Shell aus. Die folgende Ausgabe sollte angezeigt werden:

dotnet run

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

Zusammenfassung

In diesem Schritt konnten Sie alle verfügbaren Sprachen in der Translation API auflisten. Eine vollständige Liste der unterstützten Sprachen finden Sie auf der Seite Sprachunterstützung.

6. Text übersetzen

Mit der Translate API können Sie einen Text in einer Sprache in eine andere Sprache übersetzen. Text wird mit dem NMÜ-Modell (neuronale maschinelle Übersetzung) übersetzt. Wenn das NMÜ-Modell für das angeforderte Sprachübersetzungspaar nicht unterstützt wird, wird das PBMT-Modell (Phrase-Based Machine Translation) verwendet.

Um Text zu übersetzen, rufen Sie die Datei Program.cs im Ordner TranslationApiDemo auf und ersetzen Sie den Code durch Folgendes:

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

Nehmen Sie sich ein oder zwei Minuten Zeit, um sich den Code anzusehen. Es übersetzt den Text „Hello World“ aus dem Englischen ins Türkische.*

Führen Sie die App wieder in Cloud Shell aus. Die folgende Ausgabe sollte angezeigt werden:

dotnet run

Selam Dünya!

Zusammenfassung

In diesem Schritt haben Sie die Translation API verwendet, um einen Text aus dem Englischen ins Türkische zu übersetzen. Weitere Informationen zum Übersetzen von Text

7. Sprache erkennen

Mit der Translate API können Sie auch die Sprache eines Textstrings erkennen.

Um die Sprache zu erkennen, rufen Sie die Datei Program.cs im Ordner TranslationApiDemo auf und ersetzen Sie den Code durch Folgendes:

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

Nehmen Sie sich ein oder zwei Minuten Zeit, um sich den Code anzusehen. Sie erkennt die Sprache des Texts „Selam Dünya!“, der zufällig ein türkischer Ausdruck ist.*

Führen Sie die App wieder in Cloud Shell aus. Die folgende Ausgabe sollte angezeigt werden:

dotnet run

Language: tr        Confidence: 1

Zusammenfassung

In diesem Schritt haben Sie die Sprache eines Textabschnitts mithilfe der Translation API erkannt. Weitere Informationen zum Erkennen von Sprachen

8. Glückwunsch!

Sie haben gelernt, wie Sie die Translation API mit C# verwenden.

Bereinigen

So vermeiden Sie, dass Ihr Google Cloud Platform-Konto für die in diesem Schnellstart verwendeten Ressourcen belastet wird:

Rufen Sie die Cloud Platform Console auf.
Wählen Sie das Projekt aus, das Sie beenden möchten, und klicken Sie oben auf „Löschen“. Das Projekt wird dann zum Löschen geplant.

Weitere Informationen

Google Cloud Translation API: https://cloud.google.com/translate/docs
C#/.NET auf der Google Cloud Platform: https://cloud.google.com/dotnet/
Google Cloud .NET-Client: https://googlecloudplatform.github.io/google-cloud-dotnet/

Lizenz

Dieser Text ist mit einer Creative Commons Attribution 2.0 Generic License lizenziert.