Eseguire la migrazione da Basic ad Advanced

Gli utenti esistenti di Cloud Translation - Basic (v2) che vogliono utilizzare le funzionalità più recenti di Cloud Translation, come i glossari e i modelli AutoML, devono eseguire la migrazione delle loro applicazioni in modo da utilizzare Cloud Translation - Advanced (v3). Per un confronto, vedi Confronto tra le edizioni Basic e Advanced.

La migrazione alla versione avanzata include l'utilizzo di Identity and Access Management (IAM) e delle librerie client della versione avanzata. Le sezioni seguenti descrivono le attività di migrazione e le principali differenze tra le due versioni.

Migrazione ad Advanced

I passaggi riportati di seguito descrivono le azioni necessarie per aggiornare le applicazioni esistenti in modo che utilizzino Cloud Translation - Advanced anziché Cloud Translation - Basic.

1. Fai l'inventario dei progetti, delle applicazioni e degli utenti Google Cloud che accedono all'API Cloud Translation - Basic. Dovrai fornire account di servizio e aggiornarli per utilizzare le librerie client di Cloud Translation - Advanced.
2. Configura gli account di servizio e l'autenticazione per la tua applicazione.
3. Utilizza i ruoli IAM per impostare le autorizzazioni sugli account di servizio.
4. Abilita Cloud Translation - Advanced per il tuo progetto. Se utilizzi i modelli AutoML con Cloud Translation - Advanced, devi attivare anche AutoML. Per ulteriori informazioni, consulta la guida alla configurazione
5. Utilizza le librerie e i metodi client di Cloud Translation - Advanced. Per le richieste di Cloud Translation - Advanced, devi includere il numero (o l'ID) del progetto e la posizione del progetto, ad esempio global o us-central1.
6. Verifica che le dimensioni delle richieste di traduzione inviate a Cloud Translation - Advanced non superino il limite.
7. Pianifica il monitoraggio della quota delle richieste di traduzione. Entrambe le versioni dell'API condividono le stesse quote giornaliere e mensili.
8. Esamina le potenziali modifiche alla fatturazione.

Differenze principali tra le impostazioni avanzate e di base

Per aiutarti a comprendere le attività di migrazione, le sezioni seguenti descrivono le principali differenze tra le versioni avanzata e di base.

Account di servizio

Per Cloud Translation - Basic, puoi inviare richieste autenticate utilizzando chiavi API o account di servizio.

Cloud Translation - Advanced include funzionalità che richiedono risorse gestite dal cliente; queste risorse richiedono la gestione dei ruoli e delle autorizzazioni IAM. Per questo motivo, non puoi utilizzare le chiavi API per autenticarti al servizio. Devi invece utilizzare gli account di servizio per autenticarti in Cloud Translation - Advanced.

Per ulteriori informazioni, consulta la guida alla configurazione.

Ruoli IAM

Quando utilizzi gli account di servizio per Cloud Translation - Basic, questi vengono utilizzati solo per l'autenticazione. Puoi effettuare qualsiasi chiamata a Cloud Translation - Basic indipendentemente dalle autorizzazioni associate all'account di servizio. Tuttavia, per Cloud Translation - Advanced, le autorizzazioni si applicano.

Per concedere agli account di servizio le autorizzazioni per chiamare Cloud Translation - Advanced, devi assegnare loro i ruoli IAM. Cloud Translation - Advanced dispone di diversi ruoli IAM che puoi assegnare al tuo account di servizio per accedere a risorse specifiche del progetto. Ad esempio, se vuoi utilizzare il tuo account di servizio per tradurre il testo, devi assegnargli il ruolo roles/cloudtranslate.user. Per saperne di più, consulta i ruoli IAM in Cloud Translation - Dettagli avanzati.

Se prevedi di utilizzare i modelli AutoML o qualsiasi funzionalità basata su Cloud Storage, devi includere anche i ruoli appropriati per questi servizi. Per visualizzare un elenco di tutti i ruoli IAM, consulta la documentazione relativa ai ruoli IAM.

Modelli di traduzione

Quando richiedi una traduzione utilizzando Cloud Translation - Basic, Google utilizza un modello di traduzione automatica neurale (NMT) preaddestrato. Per Cloud Translation - Advanced, puoi utilizzare il modello NMT preaddestrato o un modello personalizzato di AutoML Translation.

Gli account di servizio che utilizzi per le richieste di traduzione devono disporre delle autorizzazioni per accedere ai modelli NMT e AutoML, che possono trovarsi in progetti diversi. Ad esempio, potresti avere un progetto centrale che contenga i tuoi modelli di traduzione per semplificare la manutenzione e la fatturazione. Gli account di servizio di quel progetto o di altri progetti possono utilizzare questi modelli, ma richiedono le autorizzazioni per farlo.

Per saperne di più sui modelli di traduzione, consulta Tradurre il testo (avanzato).

Librerie client

Le librerie client e i metodi di Cloud Translation - Advanced sono diversi da quelli di Cloud Translation - Basic. Ad esempio, le chiamate a Cloud Translation - Advanced richiedono nomi delle risorse. Per ulteriori informazioni, consulta la panoramica delle librerie client avanzate di Cloud Translation o prova la guida rapida per tradurre il testo (versione avanzata).

Risorse, progetti e località

Le richieste a Cloud Translation - Advanced richiedono il nome della risorsa che vuoi utilizzare. Una risorsa è in genere un nome qualificato che include il nome del progetto e la relativa posizione, che specifica dove viene eseguita la richiesta. Ad esempio, il nome di un modello AutoML è un nome risorsa.

Se il tuo progetto Google Cloud si chiama my-project e la posizione della risorsa è us-central1, il nome completo delle risorse potrebbe essere simile al seguente:

projects/MY_PROJECT/locations/us-central1/...

L'URL a cui invii una richiesta getSupportedLanguages potrebbe avere il seguente aspetto:

https://translation.googleapis.com/v3/projects/my-project/locations/us-central1/supportedLanguages

Nota: tutte le risorse in una singola richiesta a Cloud Translation - Advanced devono avere la stessa località. Al momento sono supportati solo i valori global e us-central1. Per tutte le risorse personalizzate (modelli AutoML, glossari, operazioni a lungo termine), devi utilizzare us-central1. Puoi anche utilizzare us-central1 quando utilizzi modelli di traduzione generale e il rilevamento della lingua. Puoi utilizzare la posizione global solo se utilizzi modelli di traduzione generale e il rilevamento della lingua.

Cloud Translation - Advanced fornisce anche endpoint multiregionali, come translate-eu.googleapis.com per mantenere la gestione dei dati all'interno dell'UE. Si tratta di un endpoint unico per l'UE e non di un'impostazione di località nell'API globale. Per ulteriori informazioni, consulta Endpoint globali e multiregionali.

Limite di contenuti per richiesta

L'API Cloud Translation è ottimizzata per la traduzione di piccole richieste. La lunghezza massima consigliata per ogni richiesta è 5000 caratteri (punti di codice). Tuttavia, maggiore è il numero di caratteri inclusi, più alta è la latenza di risposta. Per Cloud Translation - Advanced, il numero massimo di punti di codice per una singola richiesta è 30.000. Cloud Translation - Basic ha una dimensione massima della richiesta di 100.000 byte.

L'API Cloud Translation rifiuta le richieste con dimensioni superiori al massimo e restituisce un errore 400 INVALID_ARGUMENT indipendentemente dalla quota disponibile.

Per ulteriori informazioni su quote e limiti, consulta Quote.

Passaggi successivi

Utilizza Cloud Translation - Advanced per tradurre text, creare glossari o inviare richieste collettive.