Configurazione

Per iniziare a utilizzare Cloud Translation, devi disporre di un progetto in cui è attivata l'API Cloud Translation e di credenziali 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 prevede l'utilizzo della console Google Cloud, 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 pagina della console Cloud per ulteriori informazioni.

Prima di iniziare

Cloud Translation è disponibile in due versioni (Di base e Avanzata). Decidi quale versione utilizzare, perché ogni versione ha il proprio insieme di librerie client.

Crea o seleziona un progetto

Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. che organizza tutte le risorse 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 solo progetto, Oppure puoi creare più progetti e utilizzarle per organizzare le risorse Google Cloud gerarchia delle risorse. Quando crei un progetto, prendi nota dell'ID progetto. Ti servirà questo ID 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.

Go to project selector

Abilita fatturazione

Per utilizzare Cloud Translation, devi abilitare la fatturazione. Per ulteriori informazioni 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 progetti. Per ulteriori informazioni, vedi Impostare le quote di utilizzo.

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 quando crei un progetto. Per ulteriori informazioni, consulta Documentazione sulla fatturazione.

Make sure that billing is enabled for your Google Cloud project.

Attivazione dell'API

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

Enable the Cloud Translation API.

Enable the API

Impostare le quote di utilizzo

Cloud Translation dispone di un sistema di gestione delle quote che consente a te e a Google di gestire all'utilizzo del servizio. Per impostazione predefinita, il numero di caratteri che è possibile inviare per un 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 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 Eseguire l'autenticazione in Cloud Translation.

Ruoli di Identity and Access Management

Quando un principale (account utente, account di servizio e così via) chiama un'API, Google Cloud richiede che il principale 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.

Nota: le autorizzazioni dei ruoli si applicano solo a Cloud Translation - Advanced. Sebbene puoi utilizzare gli account di servizio per entrambe le versioni, puoi impostare solo autorizzazioni specifiche per Cloud Translation - Advanced. Per Cloud Translation - Basic, puoi effettuare qualsiasi richiesta a prescindere dalle autorizzazioni dell'account di servizio.

Installazione delle librerie client

Le librerie client sono disponibili per diversi linguaggi diffusi. È 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 servono o non è disponibile per il tuo linguaggio, crea un codice personalizzato. Per Per ulteriori informazioni, consulta la sezione Utilizzo del tuo 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 ulteriori informazioni, consulta la sezione Informazioni sulle librerie client nella documentazione delle API Cloud.

Librerie client Cloud Translation - Basic

Seleziona il linguaggio di programmazione che stai utilizzando 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

Attenzione: la libreria client Java non supporta Android.

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.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.50.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>

If you are using Gradle, add the following to your dependencies:

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support 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 --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

Librerie client di Cloud Translation - Advanced

Seleziona il linguaggio di programmazione che stai utilizzando 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

Attenzione:la libreria client Java non supporta Android.

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.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.50.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>

If you are using Gradle, add the following to your dependencies:

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support 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 --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 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 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

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 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 viene utilizzato da tutti i sample REST della riga di comando di Cloud Translation per autenticare le chiamate API.

Passaggi successivi

• Prova le guide rapide per effettuare chiamate di traduzione semplici:

  • Cloud Translation - Guida rapida di base
  • Cloud Translation - Quickstart avanzato

• Visualizza le guide illustrative per ulteriori informazioni su utilizzando varie funzionalità di Cloud Translation.

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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Prova Cloud Translation gratuitamente