Configurazione

Per iniziare a utilizzare Cloud Translation, devi avere un progetto in cui sia abilitata l'API Cloud Translation e le credenziali per effettuare chiamate autenticate. Le sezioni seguenti descrivono in dettaglio come eseguire la configurazione prima di effettuare la prima chiamata all'API Cloud Translation.

Il processo di configurazione prevede l'utilizzo della Google Cloud console, 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 Google Cloud console, consulta la pagina della console Google Cloud per saperne di più.

Prima di iniziare

Cloud Translation è disponibile in due versioni (Basic e Advanced). Decidi quale versione utilizzare perché ognuna ha il 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 Google Cloud risorse. Un progetto è composto da un gruppo di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, informazioni di fatturazione, e controlli di autenticazione e accesso. Puoi creare un progetto, oppure creare più progetti e utilizzarli per organizzare le tue Google Cloud risorse in una gerarchia di risorse. Quando crei un progetto, prendi nota dell' ID progetto. Avrai bisogno di questo ID per effettuare chiamate API. Per saperne di più sui progetti, consulta la documentazione di Resource Manager.

Ti consigliamo di creare progetti separati per esperimenti, test e produzione. Dopo aver creato un progetto, annota il numero o l' ID progetto. Devi fornire il numero (o l'ID) del progetto quando effettui chiamate all'API Cloud Translation.

Nella Google Cloud console, nella pagina di selezione del progetto, seleziona o crea un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico: puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

Vai al selettore di progetti

Abilita fatturazione

Devi abilitare la fatturazione per utilizzare Cloud Translation. Per saperne di più sui prezzi di Cloud Translation, consulta la pagina dei prezzi.

Nota: per aiutarti a gestire il budget, puoi impostare i limiti di utilizzo per i tuoi progetti. Per saperne di più, consulta Imposta le quote di utilizzo.

Un account di fatturazione viene utilizzato per definire chi paga per 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, configuri la fatturazione quando crei un progetto. Per saperne di più, consulta la documentazione di fatturazione.

Verifica che la fatturazione sia abilitata per il tuo Google Cloud progetto.

Attivazione dell'API

Devi abilitare l'API Cloud Translation per il tuo progetto. Per saperne di più sull'abilitazione delle API, consulta la documentazione di Service Usage.

Abilita l'API Cloud Translation.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore di Service Usage (roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilitare l'API

Imposta le quote di utilizzo

Cloud Translation ha un sistema di gestione delle quote per aiutare te e Google a gestire l'utilizzo del servizio. Per impostazione predefinita, il numero di caratteri che puoi inviare al giorno è illimitato. Se hai un budget prestabilito, 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 utilizza l'API deve essere autenticata e deve avere accesso alle risorse richieste. Per saperne di più, consulta Autenticazione a 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 i ruoli a un'entità. Per saperne di più, consulta Controllare l'accesso con IAM.

Nota: le autorizzazioni dei ruoli si applicano solo a Cloud Translation - Advanced. Sebbene tu possa utilizzare i service account per entrambe le versioni, puoi impostare autorizzazioni specifiche solo per Cloud Translation - Advanced. Per Cloud Translation - Basic, puoi effettuare qualsiasi richiesta indipendentemente dalle autorizzazioni del account di servizio account.

Installazione delle librerie client

Le librerie client sono disponibili per diversi linguaggi comuni. Ti consigliamo di utilizzare queste librerie client per effettuare chiamate a Cloud Translation perché semplificano l'accesso alle API. Se una libreria client non soddisfa le tue esigenze o non è disponibile per la tua lingua, crea il tuo codice personalizzato. Per saperne di più, consulta Utilizzare il proprio codice client code.

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 credenziali nel codice. Per saperne di più, consulta Descrizione delle librerie client nella documentazione delle API Cloud.

Librerie client di Cloud Translation - Basic

Seleziona il linguaggio di programmazione che stai utilizzando per lo sviluppo, quindi esegui il comando correlato. Per saperne di più, consulta la panoramica delle librerie client di Cloud Translation - Basic.

C#

nuget install Google.Cloud.Translation.V2

Vai

go get cloud.google.com/go/translate

Java

Attenzione: la libreria client Java non supporta Android.

Se utilizzi Maven, aggiungi quanto segue al file pom.xml. Per saperne di più sulle BOM, consulta La BOM delle librerie di Google Cloud.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.78.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 'com.google.cloud:google-cloud-translate:2.87.0'

Se utilizzi sbt, aggiungi quanto segue alle dipendenze:

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

Se utilizzi Visual Studio Code o IntelliJ, puoi aggiungere librerie client al tuo progetto utilizzando i seguenti plug-in IDE:

• Cloud Code for VS Code
• Cloud Code for IntelliJ

I plug-in forniscono funzionalità aggiuntive, come la gestione delle chiavi per i service account. Per informazioni dettagliate, consulta la documentazione di ogni plug-in.

Nota: le librerie client Java di Cloud non supportano attualmente Android.

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 @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Per saperne di più 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 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

Librerie client di Cloud Translation - Advanced

Seleziona il linguaggio di programmazione che stai utilizzando per lo sviluppo, quindi esegui il comando correlato. Per saperne di più, consulta la panoramica delle librerie client di Cloud Translation - Advanced .

C#

nuget install Google.Cloud.Translate.V3 -Pre

Vai

go get cloud.google.com/go/translate/apiv3

Java

Attenzione: la libreria client Java non supporta Android.

Se utilizzi Maven, aggiungi quanto segue al file pom.xml. Per saperne di più sulle BOM, consulta La BOM delle librerie di Google Cloud.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.78.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 'com.google.cloud:google-cloud-translate:2.87.0'

Se utilizzi sbt, aggiungi quanto segue alle dipendenze:

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

Se utilizzi Visual Studio Code o IntelliJ, puoi aggiungere librerie client al tuo progetto utilizzando i seguenti plug-in IDE:

• Cloud Code for VS Code
• Cloud Code for IntelliJ

I plug-in forniscono funzionalità aggiuntive, come la gestione delle chiavi per i service account. Per informazioni dettagliate, consulta la documentazione di ogni plug-in.

Nota: le librerie client Java di Cloud non supportano attualmente Android.

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 @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Per saperne di più 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 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

Nota: puoi saltare questo passaggio se non utilizzerai la riga di comando per effettuare chiamate API autenticate.

Se prevedi di inviare richieste di Cloud Translation tramite la riga di comando (ad esempio tramite comandi curl), installa e inizializza gcloud CLI , incluso in Google Cloud CLI. Il seguente link fornisce ulteriori informazioni:

Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

gcloud init

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Testare l'SDK e l'autenticazione

Se hai configurato la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS, puoi utilizzare gcloud per testare l'ambiente di autenticazione. Esegui il comando seguente 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 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:

  • Guida rapida di Cloud Translation - Basic
  • Guida rapida di Cloud Translation - Advanced

• Per saperne di più sull'utilizzo delle varie funzionalità di Cloud Translation, consulta la panoramica del prodotto per ulteriori informazioni su.

Provalo

Se non conosci Google Cloud, crea un account per valutare le prestazioni di Cloud Translation in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

Prova Cloud Translation senza costi