Configurazione
Per iniziare a utilizzare Cloud Translation, devi avere un progetto con l'API Cloud Translation abilitata e le credenziali per effettuare chiamate autenticate. Le sezioni seguenti spiegano come eseguire la configurazione prima di effettuare la prima chiamata all'API Cloud Translation.
Il processo di configurazione riguarda Google Cloud Console, che è un'interfaccia web che puoi utilizzare per eseguire il provisioning, configurare, gestire e monitorare i sistemi in Google Cloud. Se non hai mai utilizzato Google Cloud Console, consulta la pagina Cloud Console per ulteriori informazioni.
Prima di iniziare
Cloud Translation è disponibile in due versioni(Basic e Advanced). Decidi quale versione utilizzare perché determina la versione delle librerie client che installerai.
Crea o seleziona un progetto
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. Un progetto organizza tutte le tue risorse di Google Cloud. Un progetto è composto da un insieme di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, dati di fatturazione e controlli di autenticazione e accesso. Puoi creare un singolo progetto oppure più progetti e utilizzarli per organizzare le risorse di Google Cloud in una gerarchia di risorse. Quando crei un progetto, prendi nota dell'ID progetto. Questo ID ti servirà per effettuare chiamate API. Per ulteriori informazioni sui progetti, consulta la documentazione di Resource Manager.
Ti consigliamo di creare progetti separati per esperimenti, test e produzione. Dopo aver creato un progetto, registra il numero o ID del progetto. Devi fornire il numero di progetto (o l'ID) quando effettui chiamate all'API Cloud Translation.
Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.
Abilitare la fatturazione
Per utilizzare Cloud Translation, devi abilitare la fatturazione. Per ulteriori informazioni sui prezzi di Cloud Translation, consulta la pagina sui prezzi.
Un account di fatturazione viene utilizzato per definire chi paga per un determinato set di risorse e può essere collegato a uno o più progetti. L'utilizzo del progetto viene addebitato all'account di fatturazione collegato. Nella maggior parte dei casi, la configurazione viene configurata quando crei un progetto. Per ulteriori informazioni, consulta la documentazione sulla fatturazione.
Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.
Attivazione dell'API
Devi abilitare l'API Cloud Translation per il tuo progetto. Per ulteriori informazioni sull'abilitazione delle API, consulta la documentazione sull'utilizzo dei servizi.
Attiva Cloud Translation API.
Imposta quote di utilizzo
Cloud Translation offre un sistema di gestione della quota che consente a te e a Google di gestire l'utilizzo del servizio. Per impostazione predefinita, il numero di caratteri che puoi inviare al giorno è illimitato. Se hai un budget fisso, ti consigliamo di monitorare l'utilizzo giornaliero e di modificare le quote in base alla tua spesa pianificata.
Per ulteriori informazioni, vedi Quote e limiti.
Configura l'autenticazione
Se prevedi di utilizzare l'API Cloud Translation, devi configurare l'autenticazione. Qualsiasi applicazione client che utilizza l'API deve essere autenticata e ottenere l'accesso alle risorse richieste. In questa sezione sono descritti importanti concetti sull'autenticazione e sono descritti i passaggi per la configurazione. Per maggiori informazioni, consulta la panoramica sull'autenticazione di Google Cloud.
Account di servizio e chiave privata
Esistono diverse opzioni per l'autenticazione, ma è consigliabile utilizzare account di servizio per l'autenticazione e il controllo dell'accesso. Un account di servizio fornisce le credenziali per le applicazioni anziché gli utenti finali. Gli account di servizio sono di proprietà dei progetti e puoi crearne molti per un progetto. Per ulteriori informazioni, consulta la sezione Informazioni sugli account di servizio.
Gli account di servizio sono associati a una o più coppie di chiavi pubblica/privata. Quando crei una nuova coppia di chiavi, viene scaricata la chiave privata. La chiave privata viene utilizzata per generare le credenziali quando si chiama l'API. Sei responsabile della sicurezza della chiave privata e di altre operazioni di gestione, come la rotazione della chiave.
Ruoli gestione di identità e accessi
Quando un'identità chiama un'API, Google Cloud richiede che l'identità disponga delle autorizzazioni appropriate. Per concedere le autorizzazioni, concedi i ruoli a un account di servizio. Per saperne di più, consulta la documentazione relativa a Identity and Access Management (IAM).
Creazione di account e chiavi di servizio
Crea un account di servizio:
-
In Cloud Console, vai alla pagina Crea account di servizio.
Vai a Crea account di servizio - Seleziona il progetto.
-
Inserisci un nome nel campo Nome account di servizio. Cloud Console compila il campo ID account di servizio in base a questo nome.
Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio,
Service account for quickstart
. - Fai clic su Crea e continua.
-
Per fornire l'accesso al tuo progetto, concedi i seguenti ruoli al tuo account di servizio: Progetto > proprietario.
Nell'elenco Seleziona un ruolo, scegli un ruolo.
Per ulteriori ruoli, fai clic su
Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo. - Fai clic su Continua.
-
Fai clic su Fine per completare la creazione dell'account di servizio.
Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.
Crea una chiave dell'account di servizio:
- In Cloud Console, fai clic sull'indirizzo email dell'account di servizio che hai creato.
- Fai clic su Chiavi.
- Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
- Fai clic su Crea. Il file di una chiave JSON viene scaricato sul computer.
- Fai clic su Chiudi.
Per ulteriori informazioni sui diversi ruoli, consulta i ruoli di Cloud Translation - Avanzati. Ad esempio, se vuoi consentire al tuo account di servizio di tradurre il testo, assegnagli il ruolo roles/cloudtranslate.user
. Tutte le chiavi associate a tale account di servizio ricevono le stesse autorizzazioni.
Utilizzo del file della chiave dell'account di servizio nell'ambiente
Fornisci le credenziali di autenticazione al codice della tua applicazione impostando la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS
. Questa
variabile si applica solo alla sessione shell corrente. Se vuoi che la variabile
venga applicata alle sessioni shell future, impostala nel file di avvio della shell,
ad esempio nel file ~/.bashrc
o ~/.profile
.
Linux o macOS
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH
"
Sostituisci KEY_PATH
con il percorso del file JSON che contiene la chiave dell'account di servizio.
Ad esempio:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
Windows
Per PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH
"
Sostituisci KEY_PATH
con il percorso del file JSON che contiene la chiave dell'account di servizio.
Ad esempio:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
Per il prompt dei comandi:
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
Sostituisci KEY_PATH
con il percorso del file JSON che contiene la chiave dell'account di servizio.
In alternativa, puoi posizionare il puntatore sul file JSON nel tuo codice. Per ulteriori informazioni, consulta la sezione Trasmettere le credenziali utilizzando il codice.
Installazione delle librerie client
Sono disponibili librerie client per vari linguaggi diffusi. Ti consigliamo di utilizzare queste librerie client per effettuare chiamate a Cloud Translation, dato che semplificano l'accesso alle API.
Ad esempio, l'utilizzo di una libreria client può determinare implicitamente le tue credenziali tramite la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS
.
Non è necessario specificare esplicitamente le credenziali nel codice. Per ulteriori informazioni, consulta la sezione Librerie client nella documentazione delle API Cloud.
Cloud Translation - Librerie client di base
Seleziona il linguaggio di programmazione che stai utilizzando per lo sviluppo, quindi esegui il relativo comando. Per ulteriori informazioni, consulta la panoramica sulle librerie client di base di Cloud Translation.
C#
nuget install Google.Cloud.Translation.V2
Go
go get cloud.google.com/go/translate
Java
Se utilizzi Maven, aggiungi quanto segue al file pom.xml
. Per ulteriori informazioni sui
BOM, consulta la pagina BOM delle librerie Google Cloud Platform.
Se utilizzi Gradle, aggiungi quanto segue alle dipendenze:
Se utilizzi sbt, aggiungi quanto segue alle dipendenze:
Se utilizzi Visual Studio Code, IntelliJ o Eclipse, puoi aggiungere librerie client al progetto utilizzando i seguenti plug-in IDE:
I plug-in offrono funzionalità aggiuntive, come la gestione delle chiavi per gli account di servizio. Per informazioni dettagliate, consulta la documentazione di ogni plug-in.
Node.js
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Node.js, consulta la guida alla configurazione dell'ambiente di sviluppo Node.js.
npm install --save @google-cloud/translate
PHP
composer require google/cloud-translate
Python
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Python, consulta la guida alla configurazione dell'ambiente di sviluppo Python.
pip install google-cloud-translate==2.0.1
Ruby
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Ruby, consulta la Guida alla configurazione dell'ambiente di sviluppo Ruby.
gem install google-cloud-translate-v2
Cloud Translation - Librerie client avanzate
Seleziona il linguaggio di programmazione che stai utilizzando per lo sviluppo, quindi esegui il relativo comando. Per saperne di più, consulta la Cloud Translation avanzata - Panoramica delle librerie client.
C#
nuget install Google.Cloud.Translate.V3 -Pre
Go
go get cloud.google.com/go/translate/apiv3
Java
Se utilizzi Maven, aggiungi quanto segue al file pom.xml
. Per ulteriori informazioni sui
BOM, consulta la pagina BOM delle librerie Google Cloud Platform.
Se utilizzi Gradle, aggiungi quanto segue alle dipendenze:
Se utilizzi sbt, aggiungi quanto segue alle dipendenze:
Se utilizzi Visual Studio Code, IntelliJ o Eclipse, puoi aggiungere librerie client al progetto utilizzando i seguenti plug-in IDE:
I plug-in offrono funzionalità aggiuntive, come la gestione delle chiavi per gli account di servizio. Per informazioni dettagliate, consulta la documentazione di ogni plug-in.
Node.js
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Node.js, consulta la guida alla configurazione dell'ambiente di sviluppo Node.js.
npm install --save @google-cloud/translate
PHP
composer require google/cloud-translate
Python
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Python, consulta la guida alla configurazione dell'ambiente di sviluppo Python.
pip install --upgrade google-cloud-translate
Ruby
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Ruby, consulta la Guida alla configurazione dell'ambiente di sviluppo Ruby.
gem install google-cloud-translate
Installa l'interfaccia a riga di comando di Google Cloud
Se prevedi di inviare richieste Cloud Translation dalla riga di comando (ad esempio tramite comandi curl), installa e inizializza l'interfaccia a riga di comando gcloud, inclusa nell'interfaccia a riga di comando di Google Cloud. Il seguente link fornisce ulteriori informazioni:
Installa e inizializza l'interfaccia a riga di comando di Google Cloud.Testare l'SDK e l'autenticazione
Se hai configurato la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS
,
puoi utilizzare gcloud
per testare il tuo ambiente di autenticazione. Esegui il comando seguente e verifica che non si verifichino errori e che le credenziali vengano restituite:
gcloud auth application-default print-access-token
Il comando precedente è utilizzato da tutti gli esempi di REST della riga di comando di Cloud Translation per autenticare le chiamate API.
Passaggi successivi
Prova le guide rapide per effettuare semplici chiamate di traduzione:
Consulta le guide illustrative per ulteriori informazioni sull'utilizzo di varie funzionalità di Cloud Translation.
Provalo
Se non hai mai utilizzato Google Cloud, crea un account per valutare le prestazioni di Cloud Translation in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Prova Cloud Translation gratuitamente