Configurazione

Per iniziare a utilizzare Cloud Translation, devi disporre di un progetto con l'API Cloud Translation abilitata e delle credenziali per effettuare chiamate autenticate. Le sezioni seguenti descrivono in dettaglio come configurare l'ambiente 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 inGoogle Cloud. Se non hai mai utilizzato la console Google Cloud , consulta la pagina Console Cloud per saperne di più.

Prima di iniziare

Cloud Translation è disponibile in due versioni (Basic e Advanced). Decidi quale edizione utilizzare perché ogni edizione 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, informazioni di fatturazione, controlli di autenticazione e accesso. Puoi creare un progetto o più progetti e utilizzarli per organizzare le risorse Google Cloud in una gerarchia delle 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, registra il numero o l'ID progetto. Devi fornire il numero (o l'ID) del progetto quando effettui chiamate all'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.

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, la fatturazione viene configurata quando crei un progetto. Per ulteriori informazioni, consulta la 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'attivazione delle API, consulta la documentazione di Service Usage.

Enable the Cloud Translation API.

Enable the API

Impostare quote di utilizzo

Cloud Translation dispone di 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 ulteriori informazioni, consulta Autenticarsi in Cloud Translation.

Ruoli Identity and Access Management

Quando un principal (account utente, account di servizio e così via) chiama un'API, Google Cloud richiede che il principal disponga delle autorizzazioni appropriate. Puoi concedere autorizzazioni assegnando ruoli a un'entità. Per ulteriori informazioni, consulta Controllare l'accesso con IAM.

Installazione delle librerie client

Le librerie client sono disponibili per diversi linguaggi popolari. 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 maggiori informazioni, consulta Utilizzo del codice cliente.

Ad esempio, quando utilizzi una libreria client, 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 la sezione Spiegazione 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.

nuget install Google.Cloud.Translation.V2

go get cloud.google.com/go/translate

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

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

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

npm install @google-cloud/translate

composer require google/cloud-translate

pip install google-cloud-translate==2.0.1

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.

nuget install Google.Cloud.Translate.V3 -Pre

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

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

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

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

npm install @google-cloud/translate

composer require google/cloud-translate

pip install --upgrade google-cloud-translate

gem install google-cloud-translate

Installa Google Cloud CLI

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

After installing the Google Cloud CLI, initialize it by running the following command:

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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 questo comando e verifica che non si verifichi alcun errore 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
  • Cloud Translation - Avvio rapido avanzato

• Per saperne di più sull'utilizzo delle varie funzionalità di Cloud Translation, consulta le guide pratiche.