Configurazione
Per iniziare a utilizzare Cloud Translation, devi avere un progetto che includa l'API Cloud Translation e le credenziali necessarie per effettuare chiamate autenticate. Le seguenti sezioni spiega come eseguire la configurazione prima di effettuare la prima chiamata all'API Cloud Translation.
Il processo di configurazione coinvolge la console Google Cloud, che è un'interfaccia web per eseguire il provisioning, configurare, gestire e monitorare i sistemi in Google Cloud. Se non hai mai utilizzato la console Google Cloud, consulta pagina della console Cloud per ulteriori informazioni.
Prima di iniziare
Cloud Translation è disponibile in due versioni (Basic e Advanced). Decidi quale utilizzata perché ogni versione ha un proprio set di librerie client.
Crea o seleziona un progetto
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. Un progetto organizza tutte le tue risorse Google Cloud. Un progetto è composto da un insieme di collaboratori API (e altre risorse) abilitate, strumenti di monitoraggio, dati di fatturazione, e i controlli di autenticazione e accesso. Puoi creare un solo progetto, Oppure puoi creare più progetti e utilizzarle per organizzare le risorse Google Cloud gerarchia delle risorse. Quando crei un progetto, tieni presente ID progetto. Questo ID è necessario per effettuare chiamate API. Per ulteriori informazioni sui progetti, consulta documentazione di Resource Manager.
Ti consigliamo di creare progetti distinti per esperimenti, test e produzione. Dopo aver creato un progetto, registra il numero di progetto o ID. Devi fornire il numero (o l'ID) del progetto quando effettui chiamate al l'API Cloud Translation.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Abilita fatturazione
Per utilizzare Cloud Translation, devi abilitare la fatturazione. Per ulteriori informazioni Per i prezzi di Cloud Translation, consulta la pagina dei prezzi.
Un account di fatturazione viene utilizzato per definire chi deve pagare per un 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 fatturazione viene configurata al momento della creazione di un progetto. Per ulteriori informazioni, consulta Documentazione sulla fatturazione.
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
Attivazione dell'API
Devi abilitare l'API Cloud Translation per il tuo progetto. Per ulteriori informazioni sull'abilitazione delle API, consulta Documentazione sull'utilizzo dei servizi.
Enable the Cloud Translation API.
Imposta quote di utilizzo
Cloud Translation dispone di un sistema di gestione delle quote che consente a te e a Google di gestire durante l'utilizzo del servizio. Per impostazione predefinita, il numero di caratteri che è possibile inviare per un giorno è illimitato. Se hai un budget prestabilito, ti consigliamo di monitorare l'utilizzo e l'adeguamento delle quote in base alla spesa pianificata.
Per ulteriori informazioni sulle quote, consulta 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 concessa l'accesso alle risorse richieste. Per ulteriori informazioni, consulta Autenticazione per Cloud Translation.
Ruoli di Identity and Access Management
Quando un'entità (account utente, account di servizio e così via) chiama un'API, Google Cloud richiede che l'entità disponga delle autorizzazioni appropriate. Puoi concedere le autorizzazioni concedendo ruoli a un'entità. Per maggiori informazioni informazioni, consulta la sezione Controllare l'accesso con IAM.
Installazione delle librerie client
Le librerie client sono disponibili per diversi linguaggi popolari. È consigliabile puoi utilizzare queste librerie client per effettuare chiamate a Cloud Translation perché facilitano l'accesso alle API. Se una libreria client non soddisfa le tue che ti serve o non è disponibile per il tuo linguaggio, crea un codice personalizzato. Per Per ulteriori informazioni, consulta la sezione Utilizzo del proprio client Google Cloud.
Ad esempio, quando utilizzi una libreria client, questa può determinare le tue credenziali
in modo implicito tramite la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS
.
Non è necessario specificare esplicitamente le tue credenziali nel codice. Per maggiori informazioni
informazioni, consulta Librerie client
Spiegato nelle API Cloud
documentazione.
Cloud Translation - Librerie client di base
Seleziona il linguaggio di programmazione che utilizzi per lo sviluppo, quindi esegui il comando correlato. Per ulteriori informazioni, consulta il Cloud Translation Panoramica sulle librerie client.
C#
nuget install Google.Cloud.Translation.V2
Vai
go get cloud.google.com/go/translate
Java
If you are using Maven, add
the following to your pom.xml
file. For more information about
BOMs, see The Google Cloud Platform Libraries BOM.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
Node.js
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Node.js, consulta le 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 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 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 utilizzi per lo sviluppo, quindi esegui il comando correlato. Per ulteriori informazioni, consulta il Cloud Translation Panoramica sulle librerie client.
C#
nuget install Google.Cloud.Translate.V3 -Pre
Vai
go get cloud.google.com/go/translate/apiv3
Java
If you are using Maven, add
the following to your pom.xml
file. For more information about
BOMs, see The Google Cloud Platform Libraries BOM.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
Node.js
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Node.js, consulta le 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 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 Guida alla configurazione dell'ambiente di sviluppo Ruby.
gem install google-cloud-translate
Installa Google Cloud CLI
Se prevedi di inviare richieste di Cloud Translation tramite la riga di comando (ad esempio, tramite i comandi curl), installano e inizializzano gcloud CLI , inclusa in Google Cloud CLI. Il seguente link fornisce ulteriori informazioni:
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Testa 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 questo comando
e verificare che non si verifichino errori e che vengano restituite le credenziali:
gcloud auth application-default print-access-token
Il comando precedente è utilizzato da tutte le righe di comando REST di Cloud Translation per autenticare le chiamate API.
Passaggi successivi
Prova le guide rapide per effettuare chiamate di traduzione semplici:
Visualizza le guide illustrative per ulteriori informazioni su utilizzando varie funzionalità di Cloud Translation.
Provalo
Se non hai mai utilizzato Google Cloud, crea un account per valutare in che modo Cloud Translation funziona nel mondo reale diversi scenari. 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