Utilizzo dell'API Translation con C#

1. Panoramica

L'API Google Cloud Translation offre un'interfaccia programmatica semplice per la traduzione dinamica di una stringa arbitraria in qualsiasi lingua supportata utilizzando un sistema di traduzione automatica neurale all'avanguardia. Può essere utilizzata anche per rilevare la lingua nei casi in cui la lingua di origine è sconosciuta.

In questo codelab, ti concentrerai sull'utilizzo dell'API Translation con C#. Imparerai a elencare le lingue disponibili, tradurre il testo e rilevare la lingua di un determinato testo.

Cosa imparerai a fare

• Come utilizzare Cloud Shell
• Come abilitare l'API Translation
• Come autenticare le richieste API
• Come installare la libreria client Google Cloud per C#
• Come elencare le lingue disponibili
• Come tradurre testo
• Come rilevare la lingua

Che cosa ti serve

• Un progetto Google Cloud
• Un browser, ad esempio Chrome o Firefox
• Familiarità con C#

Sondaggio

Come utilizzerai questo tutorial?

Leggilo e basta Leggilo e completa gli esercizi

Come valuteresti la tua esperienza con C#?

Principiante Intermedio Avanzato

Come valuti la tua esperienza di utilizzo dei servizi Google Cloud Platform?

Principiante Intermedio Avanzato

2. Configurazione e requisiti

Configurazione dell'ambiente autonomo

1. Accedi alla console Google Cloud e crea un nuovo progetto o riutilizzane uno esistente. Se non hai ancora un account Gmail o Google Workspace, devi crearne uno.

• Il nome del progetto è il nome visualizzato per i partecipanti a questo progetto. È una stringa di caratteri non utilizzata dalle API di Google. Puoi sempre aggiornarlo.
• L'ID progetto è univoco in tutti i progetti Google Cloud ed è immutabile (non può essere modificato dopo l'impostazione). La console Cloud genera automaticamente una stringa univoca, di solito non ti interessa di cosa si tratta. Nella maggior parte dei codelab, dovrai fare riferimento all'ID progetto (in genere identificato come PROJECT_ID). Se l'ID generato non ti piace, puoi generarne un altro casuale. In alternativa, puoi provare a crearne uno e vedere se è disponibile. Non può essere modificato dopo questo passaggio e rimane per tutta la durata del progetto.
• Per tua informazione, esiste un terzo valore, un numero di progetto, utilizzato da alcune API. Scopri di più su tutti e tre questi valori nella documentazione.

Attenzione:un ID progetto è univoco a livello globale e non può essere utilizzato da altri dopo che lo hai selezionato. Sei l'unico utente di questo ID. Anche se un progetto viene eliminato, l'ID non può essere riutilizzato

Nota:se utilizzi un account Gmail, puoi lasciare la posizione predefinita impostata su Nessuna organizzazione. Se utilizzi un account Google Workspace, scegli una posizione adatta alla tua organizzazione.

2. Successivamente, devi abilitare la fatturazione in Cloud Console per utilizzare le risorse/API Cloud. Completare questo codelab non costa molto, se non nulla. Per arrestare le risorse ed evitare addebiti oltre a quelli previsti in questo tutorial, puoi eliminare le risorse che hai creato o il progetto. I nuovi utenti di Google Cloud possono beneficiare del programma prova senza costi di 300$.

Avvia Cloud Shell

Sebbene Google Cloud possa essere gestito da remoto dal tuo laptop, in questo codelab utilizzerai Google Cloud Shell, un ambiente a riga di comando in esecuzione nel cloud.

Nella console Google Cloud, fai clic sull'icona di Cloud Shell nella barra degli strumenti in alto a destra:

Bastano pochi istanti per eseguire il provisioning e connettersi all'ambiente. Al termine, dovresti vedere un risultato simile a questo:

Questa macchina virtuale è caricata con tutti gli strumenti per sviluppatori di cui avrai bisogno. Offre una home directory permanente da 5 GB e viene eseguita su Google Cloud, migliorando notevolmente le prestazioni e l'autenticazione della rete. Tutto il lavoro in questo codelab può essere svolto all'interno di un browser. Non devi installare nulla.

3. Abilita l'API Translation

Prima di poter iniziare a utilizzare l'API Translation, devi abilitarla. Puoi abilitare l'API utilizzando il seguente comando in Cloud Shell:

gcloud services enable translate.googleapis.com

Nota:se questo comando restituisce un errore, verifica che l'ID progetto corrente corrisponda all'ID progetto del codelab.

Utilizza il seguente comando per trovare l'ID progetto corrente utilizzato da Cloud Shell:

gcloud info | grep "project"

Se l'ID progetto non è corretto, utilizza il seguente comando per utilizzare l'ID progetto corretto:

gcloud config set project <PROJECT_ID>

Sostituisci <PROJECT_ID> con l'ID progetto corretto.

4. Installa la libreria client dell'API Google Cloud Translation per C#

Innanzitutto, crea una semplice applicazione console C# che utilizzerai per eseguire gli esempi dell'API Translation.

dotnet new console -n TranslationApiDemo

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

A questo punto, vai alla cartella TranslationApiDemo e aggiungi il pacchetto NuGet Google.Cloud.Translation.V2 al progetto:

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

Ora puoi utilizzare l'API Translation.

5. Elenco delle lingue disponibili

In questa sezione, elencherai innanzitutto tutte le lingue disponibili nell'API Translation.

Innanzitutto, apri l'editor di codice dalla parte in alto a destra di Cloud Shell:

Vai al file Program.cs all'interno della cartella TranslationApiDemo e sostituisci il codice con il seguente:

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

Prenditi un minuto o due per studiare il codice*.* Tieni presente che stiamo elencando i nomi delle lingue in inglese, ma possono essere elencati in qualsiasi lingua.

Torna in Cloud Shell ed esegui l'app. Dovresti vedere il seguente output:

dotnet run

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

Nota:se questo codice C# non funziona, verifica le istruzioni eseguite durante il passaggio Autenticare le richieste API.

Utilizza il seguente comando per verificare il valore della variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS:

echo GOOGLE_APPLICATION_CREDENTIALS

Deve restituire il valore "~/key.json".

In caso affermativo, controlla che sia stato creato un service account e che si trovi in "~/key.json" utilizzando:

cat "~/key.json"

Dovresti vedere qualcosa di simile a:

{

"type": "service_account",

"project_id": "PROJECT_ID",

"private_key_id": "ff31939192529e07f42e4535fb20bb029def1276",

"Private_key":...

In caso contrario, torna al passaggio Autentica le richieste API.

Riepilogo

In questo passaggio, hai potuto elencare tutte le lingue disponibili nell'API Translation. Puoi trovare l'elenco completo delle lingue supportate nella pagina Supporto delle lingue.

6. Traduci testo

Puoi utilizzare l'API Translate per tradurre un testo da una lingua a un'altra. Il testo viene tradotto utilizzando il modello di traduzione automatica neurale (NMT). Se il modello NMT non è supportato per la coppia di lingue di traduzione richiesta, viene utilizzato il modello di traduzione automatica basata su frasi (PBMT).

Per tradurre il testo, vai al file Program.cs all'interno della cartella TranslationApiDemo e sostituisci il codice con il seguente:

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

Prenditi un minuto o due per studiare il codice. Traduce il testo "Hello World" dall'inglese al turco*.*

Torna in Cloud Shell ed esegui l'app. Dovresti vedere il seguente output:

dotnet run

Selam Dünya!

Riepilogo

In questo passaggio, hai potuto utilizzare l'API Translation per tradurre un testo dall'inglese al turco. Scopri di più sulla traduzione di testo.

7. Rileva lingua

Puoi utilizzare l'API Translate anche per rilevare la lingua di una stringa di testo.

Per rilevare la lingua, vai al file Program.cs all'interno della cartella TranslationApiDemo e sostituisci il codice con il seguente:

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

Prenditi un minuto o due per studiare il codice. Rileva la lingua del testo "Selam Dünya!", che è una frase turca.*

Torna in Cloud Shell ed esegui l'app. Dovresti vedere il seguente output:

dotnet run

Language: tr        Confidence: 1

Riepilogo

In questo passaggio, hai potuto rilevare la lingua di un testo utilizzando l'API Translation. Scopri di più sul rilevamento della lingua.

8. Complimenti!

Hai imparato a utilizzare l'API Translation utilizzando C#.

Esegui la pulizia

Per evitare che al tuo account Google Cloud Platform vengano addebitate le risorse utilizzate in questa guida rapida, procedi come segue.

• Vai alla console Cloud Platform.
• Seleziona il progetto che vuoi chiudere, quindi fai clic su "Elimina" in alto: il progetto verrà pianificato per l'eliminazione.

Scopri di più

• API Google Cloud Translation: https://cloud.google.com/translate/docs
• C#/.NET su Google Cloud: https://cloud.google.com/dotnet/
• Client .NET di Google Cloud: https://googlecloudplatform.github.io/google-cloud-dotnet/

Licenza

Questo lavoro è concesso in licenza ai sensi di una licenza Creative Commons Attribution 2.0 Generic.