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.

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.

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 sulla fatturazione.

Verifica che la fatturazione sia attivata 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.

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 IAM (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.

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 Utilizzo del codice client personalizzato.

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.

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.83.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com