Configurazione

Per iniziare a utilizzare Cloud Translation, hai bisogno di un progetto che abbia 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 coinvolge la console Google Cloud, 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 la console Google Cloud, consulta la pagina Cloud Console per ulteriori informazioni.

Prima di iniziare

Cloud Translation è disponibile in due versioni (di base e avanzate). Decidi quale versione utilizzare perché determina quale versione delle librerie client installare.

Crea o seleziona un progetto

Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. Un progetto organizza tutte le risorse Google Cloud. Un progetto consiste di un insieme di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, dati di fatturazione e controlli di autenticazione e accesso. Puoi creare un solo progetto oppure più progetti e utilizzarli per organizzare le risorse Google Cloud in una gerarchia delle risorse. Quando crei un progetto, prendi nota dell'ID del progetto. Questo ID sarà necessario 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 l'ID del progetto. Devi fornire il numero di progetto (o l'ID) quando effettui chiamate all'API Cloud Translation.

Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Abilita fatturazione

Per utilizzare Cloud Translation devi abilitare la fatturazione. Per ulteriori informazioni sui prezzi di Cloud Translation, consulta la pagina dei prezzi.

Un account di fatturazione viene utilizzato per definire chi paga un determinato insieme 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 fatturazione viene configurata quando crei un progetto. Per scoprire di più, consulta la documentazione relativa alla fatturazione.

Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.

Attivazione dell'API

Devi attivare l'API Cloud Translation per il tuo progetto. Per scoprire di più sull'abilitazione delle API, consulta la documentazione sull'utilizzo dei servizi.

Attiva Cloud Translation API.

Abilita l'API

Imposta quote di utilizzo

Cloud Translation ha un sistema di gestione della quota per aiutare te e Google a gestire l'utilizzo del servizio. Per impostazione predefinita, il numero di caratteri che è possibile inviare al giorno è illimitato. Se hai un budget impostato, ti consigliamo di monitorare l'utilizzo giornaliero e di modificare le quote in base alla spesa pianificata.

Per saperne di più 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 utilizzi l'API deve essere autenticata e ottenere l'accesso alle risorse richieste. Questa sezione descrive importanti concetti di autenticazione e fornisce i passaggi per configurarli. Per saperne di più, consulta la panoramica sull'autenticazione di Google Cloud.

Account di servizio e chiave privata

Esistono diverse opzioni per l'autenticazione, ma è consigliabile utilizzare gli account di servizio per l'autenticazione e il controllo dell'accesso. Un account di servizio fornisce le credenziali per le applicazioni, anziché per gli utenti finali. Gli account di servizio sono di proprietà dei progetti e puoi creare molti account di servizio per un progetto. Per saperne di più, consulta la pagina Informazioni sugli account di servizio.

Gli account di servizio sono associati a una o più coppie di chiavi pubbliche/private. Quando crei una nuova coppia di chiavi, scarichi la chiave privata. La chiave privata viene utilizzata per generare credenziali quando chiami l'API. Sei responsabile della sicurezza della chiave privata e di altre operazioni di gestione, ad esempio la rotazione delle chiavi. Per saperne di più, consulta Best practice per la gestione delle chiavi degli account di servizio.

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 ulteriori informazioni, consulta la panoramica del ruolo.

Se hai creato il progetto con il tuo account utente, quest'ultimo avrà il ruolo di base Proprietario per il progetto. Questo ruolo fornisce accesso a qualsiasi API per il progetto. Tuttavia, se il progetto è stato creato da un altro account, potrebbe essere necessario concedere i ruoli all'account utente prima di poter chiamare l'API.

Creazione di account e chiavi di servizio

Crea un account di servizio:

  1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

    Vai a Crea account di servizio
  2. Seleziona il progetto.
  3. Inserisci un nome nel campo Service account name (Nome account di servizio). La console Google Cloud 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.

  4. Fai clic su Crea e continua.
  5. Per fornire l'accesso al progetto, concedi il ruolo Cloud Translation > Cloud Translation API Admin al tuo account di servizio.

    Per concedere il ruolo, trova l'elenco Seleziona un ruolo, quindi seleziona Cloud Translation > Cloud Translation API Admin.

  6. Fai clic su Continua.
  7. 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:

  1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
  2. Fai clic su Chiavi.
  3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
  4. Fai clic su Crea. Sul computer viene scaricato un file della chiave JSON.
  5. Fai clic su Chiudi.

Per ulteriori informazioni sui diversi ruoli, consulta Cloud Translation - Ruoli 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 quell'account di servizio ricevono le stesse autorizzazioni.

Utilizzo del file della chiave dell'account di servizio nel tuo 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 puntare al file JSON nel codice. Per ulteriori informazioni, consulta la pagina Trasmettere le credenziali utilizzando il codice.

Installazione delle librerie client

Sono disponibili librerie client per diversi linguaggi diffusi. Ti consigliamo di utilizzare queste librerie client per effettuare chiamate a Cloud Translation, in quanto semplificano l'accesso alle API. Se la libreria client non soddisfa le tue esigenze o non è disponibile per la tua lingua, crea il tuo codice personalizzato. Per ulteriori informazioni, consulta Utilizzo del proprio codice client.

Ad esempio, quando utilizzi una libreria client, può determinare le tue credenziali implicitamente tramite la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS. Non è necessario specificare esplicitamente le credenziali nel codice. Per ulteriori informazioni, consulta la sezione Descrizione delle 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 comando correlato. Per ulteriori informazioni, consulta la panoramica delle 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.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

Se utilizzi Gradle, aggiungi quanto segue alle dipendenze:

implementation platform('com.google.cloud:libraries-bom:26.0.0')

implementation 'com.google.cloud:google-cloud-translate'

Se utilizzi sbt, aggiungi quanto segue alle dipendenze:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.3.2"

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 saperne di più 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 saperne di più sulla configurazione del tuo ambiente di sviluppo Python, consulta la Guida alla configurazione dell'ambiente di sviluppo Python.

pip install google-cloud-translate==2.0.1

Ruby

Per saperne di più 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 comando correlato. Per ulteriori informazioni, consulta la panoramica delle librerie client avanzate di Cloud Translation.

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.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

Se utilizzi Gradle, aggiungi quanto segue alle dipendenze:

implementation platform('com.google.cloud:libraries-bom:26.0.0')

implementation 'com.google.cloud:google-cloud-translate'

Se utilizzi sbt, aggiungi quanto segue alle dipendenze:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.3.2"

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 saperne di più 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 saperne di più sulla configurazione del tuo ambiente di sviluppo Python, consulta la Guida alla configurazione dell'ambiente di sviluppo Python.

pip install --upgrade google-cloud-translate

Ruby

Per saperne di più sulla configurazione dell'ambiente di sviluppo Ruby, consulta la 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 comandi curl), installa e inizializza gcloud CLI, che è incluso in Google Cloud CLI. Il seguente link fornisce ulteriori informazioni:

Installa Google Cloud CLI, quindi inizializzalo eseguendo questo comando:

gcloud init

Testa l'SDK e l'autenticazione

Se hai impostato la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS, puoi utilizzare gcloud per testare l'ambiente di autenticazione. Esegui questo comando e verifica che non si verifichino errori e che vengano restituite le credenziali:

gcloud auth application-default print-access-token

Il comando precedente viene utilizzato da tutti gli esempi di REST della riga di comando di Cloud Translation per autenticare le chiamate API.

Passaggi successivi

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