Translation API mit C# verwenden

1. Übersicht

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

In diesem Codelab erfahren Sie, wie Sie die Translation API mit C# verwenden. Sie erfahren, wie Sie verfügbare Sprachen auflisten, Text übersetzen und die Sprache eines bestimmten Textes erkennen.

Aufgaben in diesem Lab

• Cloud Shell verwenden
• Translation API aktivieren
• API-Anfragen authentifizieren
• Google Cloud-Clientbibliothek für C# installieren
• So listen Sie verfügbare Sprachen auf
• Text übersetzen
• Sprache erkennen

Voraussetzungen

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

Umfrage

Wie möchten Sie diese Anleitung nutzen?

<ph type="x-smartling-placeholder"></ph> Nur bis zum Ende lesen Lies sie dir durch und absolviere die Übungen

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

<ph type="x-smartling-placeholder"></ph> Neuling Mittel Kompetent

Wie würden Sie Ihre Erfahrungen im Umgang mit Google Cloud Platform-Diensten bewerten?

<ph type="x-smartling-placeholder"></ph> Neuling Mittel Kompetent

2. Einrichtung und Anforderungen

Umgebung für das selbstbestimmte Lernen einrichten

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

• Der Projektname ist der Anzeigename für die Projektteilnehmer. Es handelt sich um eine Zeichenfolge, die von Google APIs nicht verwendet wird. Sie können sie jederzeit aktualisieren.
• Die Projekt-ID ist für alle Google Cloud-Projekte eindeutig und unveränderlich. Sie kann nach dem Festlegen nicht mehr geändert werden. Die Cloud Console generiert automatisch einen eindeutigen String. ist Ihnen meist egal, was es ist. In den meisten Codelabs musst du auf deine Projekt-ID verweisen, die üblicherweise als PROJECT_ID bezeichnet wird. Wenn Ihnen die generierte ID nicht gefällt, können Sie eine weitere zufällige ID generieren. Alternativ können Sie einen eigenen verwenden und nachsehen, ob er verfügbar ist. Sie kann nach diesem Schritt nicht mehr geändert werden und bleibt für die Dauer des Projekts erhalten.
• Zur Information gibt es noch einen dritten Wert, die Projektnummer, die von manchen APIs verwendet wird. Weitere Informationen zu allen drei Werten finden Sie in der Dokumentation.

Achtung:Eine Projekt-ID ist global eindeutig und kann von niemandem verwendet werden, nachdem Sie sie ausgewählt haben. Sie sind der einzige Nutzer dieser ID. Auch wenn ein Projekt gelöscht wurde, kann die ID nicht noch einmal verwendet werden

Hinweis:Wenn Sie ein Gmail-Konto verwenden, können Sie die Standardeinstellung Keine Organisation beibehalten. Wenn Sie ein Google Workspace-Konto verwenden, wählen Sie einen Standort aus, der für Ihre Organisation sinnvoll ist.

2. Als Nächstes müssen Sie in der Cloud Console die Abrechnung aktivieren, um Cloud-Ressourcen/APIs verwenden zu können. Dieses Codelab ist kostengünstig. Sie können die von Ihnen erstellten Ressourcen oder das Projekt löschen, um Ressourcen herunterzufahren, um zu vermeiden, dass über diese Anleitung hinaus Kosten anfallen. Neue Google Cloud-Nutzer haben Anspruch auf das kostenlose Testprogramm mit 300$Guthaben.

Cloud Shell starten

Sie können Google Cloud zwar von Ihrem Laptop aus der Ferne bedienen, in diesem Codelab verwenden Sie jedoch Google Cloud Shell, 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 dauert nur einen Moment. Wenn er abgeschlossen ist, sollten Sie in etwa Folgendes sehen:

Diese virtuelle Maschine verfügt über sämtliche Entwicklertools, die Sie benötigen. Es bietet ein Basisverzeichnis mit 5 GB nichtflüchtigem Speicher und läuft auf Google Cloud, wodurch die Netzwerkleistung und Authentifizierung erheblich verbessert werden. Alle Arbeiten in diesem Codelab können in einem Browser erledigt 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

Hinweis:Wenn dieser Befehl einen Fehler zurückgibt, prüfen Sie, ob die aktuelle Projekt-ID mit Ihrer Codelab-Projekt-ID übereinstimmt.

Verwenden Sie den folgenden Befehl, um die aktuelle Projekt-ID zu ermitteln, die von Cloud Shell verwendet wird:

gcloud info | grep "project"

Wenn die Projekt-ID nicht korrekt ist, verwenden Sie den folgenden Befehl, um die richtige Projekt-ID zu verwenden:

gcloud config set project <PROJECT_ID>

Ersetzen Sie <PROJECT_ID> durch die korrekte Projekt-ID.

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.

Gehen Sie als Nächstes zum Ordner TranslationApiDemo 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 oben rechts in Cloud Shell den Code-Editor:

Gehen Sie zur Datei Program.cs im Ordner TranslationApiDemo und ersetzen Sie den Code durch folgenden Code:

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

Nimm dir ein oder zwei Minuten Zeit, um den Code zu studieren.* Beachten Sie, dass die Sprachnamen auf Englisch aufgelistet werden, die Einträge aber in jeder beliebigen Sprache möglich sind.

Führen Sie die Anwendung in Cloud Shell aus. Sie sollten die folgende Ausgabe sehen:

dotnet run

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

Hinweis:Wenn dieser C#-Code bei Ihnen nicht funktioniert, überprüfen Sie die Anleitung im Schritt API-Anfragen authentifizieren.

Prüfen Sie mit dem folgenden Befehl den Wert der Umgebungsvariablen GOOGLE_APPLICATION_CREDENTIALS:

echo GOOGLE_APPLICATION_CREDENTIALS

Er sollte den Wert "~/key.json". ausgeben.

Wenn dies der Fall ist, prüfen Sie als Nächstes, ob ein Dienstkonto erstellt wurde und sich unter "~/key.json" befindet. Verwenden Sie dazu folgenden Befehl:

cat "~/key.json"

Die Ausgabe sollte in etwa so aussehen:

{

"type": "service_account",

"project_id": "PROJECT_ID",

"private_key_id": "ff31939192529e07f42e4535fb20bb029def1276",

"Private_key":...

Falls nicht, kehren Sie zum Schritt API-Anfragen authentifizieren zurück.

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

Sie können die Translate API verwenden, um einen Text von einer Sprache in eine andere zu übersetzen. Text wird mithilfe des Modells Neural Machine Translation (NMT) übersetzt. Wenn das NMÜ-Modell für das angeforderte Sprachübersetzungspaar nicht unterstützt wird, kommt das PBMT-Modell (Phrase-Based Machine Translation) zum Einsatz.

Zum Übersetzen von Text öffnen Sie die Datei Program.cs im Ordner TranslationApiDemo und ersetzen Sie den Code durch den folgenden Code:

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 bis zwei Minuten Zeit, um sich den Code anzusehen. Es übersetzt den Text „Hallo Welt“ vom Englischen ins Türkische*.*

Führen Sie die Anwendung in Cloud Shell aus. Sie sollten die folgende Ausgabe sehen:

dotnet run

Selam Dünya!

Zusammenfassung

In diesem Schritt konnten Sie mithilfe der Translation API einen Text vom Englischen ins Türkische übersetzen. Weitere Informationen zum Übersetzen von Text

7. Sprache erkennen

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

Rufen Sie zur Erkennung der Sprache im Ordner TranslationApiDemo die Datei Program.cs auf und ersetzen Sie den Code durch den folgenden Code:

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 bis zwei Minuten Zeit, um sich den Code anzusehen. Er erkennt die Sprache des Textes „Selam Dünya!“ Dies ist eine türkische Wortgruppe*.*

Führen Sie die Anwendung in Cloud Shell aus. Sie sollten die folgende Ausgabe sehen:

dotnet run

Language: tr        Confidence: 1

Zusammenfassung

In diesem Schritt haben Sie die Sprache eines Textes mithilfe der Translation API erkannt. Weitere Informationen zur Spracherkennung

8. Glückwunsch!

Jetzt wissen Sie, 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 auf „Löschen“. oben: Dadurch wird das Projekt zum Löschen vorgemerkt.

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.