Esegui 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 a Cloud Translation - Advanced (v3). Per un confronto, vedi Confronta le versioni Basic e Advanced.

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

Migrazione ad Advanced

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

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

Differenze principali tra Advanced e Basic

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

Service account

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

Cloud Translation - Advanced dispone di funzionalità che richiedono risorse gestite dal cliente; queste risorse richiedono la gestione di ruoli e autorizzazioni IAM. Per questo motivo, non puoi utilizzare le chiavi API per autenticarti al servizio. Devi invece utilizzare i service account per l'autenticazione a Cloud Translation - Advanced.

Per saperne di più, consulta la guida alla configurazione.

Ruoli IAM

Quando utilizzi i service account per Cloud Translation - Basic, questi vengono utilizzati solo per l'autenticazione. Puoi effettuare chiamate a Cloud Translation - Basic indipendentemente dalle autorizzazioni associate al service account. Tuttavia, per Cloud Translation - Advanced, le autorizzazioni sono necessarie.

Per concedere ai service account le autorizzazioni per chiamare Cloud Translation - Advanced, devi assegnare loro ruoli IAM. Cloud Translation - Advanced dispone di diversi ruoli IAM che puoi assegnare al service account per permettere l'accesso a risorse specifiche del tuo progetto. Ad esempio, se vuoi utilizzare il tuo service account per tradurre il testo, dovrai assegnargli il ruolo roles/cloudtranslate.user. Per saperne di più, consulta Ruoli IAM in Dettagli di Cloud Translation - Advanced.

Se prevedi di utilizzare modelli AutoML o funzionalità che si basano 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. Con Cloud Translation - Advanced, puoi utilizzare il modello NMT preaddestrato, l'LLM di traduzione o un modello AutoML Translation personalizzato.

I service account 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 contiene i modelli di traduzione per semplificare la manutenzione e la fatturazione. I service account in quel progetto o in altri progetti possono utilizzare questi modelli, ma per farlo necessitano delle autorizzazioni.

Per saperne di più sui modelli di traduzione, consulta Traduzione del testo (Advanced).

Librerie client

Le librerie client e i metodi per Cloud Translation - Advanced differiscono da Cloud Translation - Basic. Ad esempio, le chiamate a Cloud Translation - Advanced richiedono i nomi delle risorse. Per saperne di più, consulta la panoramica delle librerie client di Cloud Translation - Advanced o prova la guida rapida per la traduzione di testo (versione Advanced).

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 località, che specifica dove viene eseguita la richiesta. Ad esempio, il nome di un modello AutoML è un nome della risorsa.

Se il tuo progetto Google Cloud ha il nome my-project e la località della risorsa è us-central1, il nome completo delle tue 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 supportate solo le località global e us-central1. Per tutte le risorse personalizzate (modelli AutoML, glossari, operazioni a lunga esecuzione) devi utilizzare us-central1. Puoi utilizzare us-central1 anche quando utilizzi modelli di traduzione generici e il rilevamento della lingua. Puoi utilizzare la località global solo quando utilizzi modelli di traduzione generici e il rilevamento della lingua.

Cloud Translation - Advanced fornisce anche endpoint multiregionali, ad esempio translate-eu.googleapis.com per mantenere la gestione dei dati all'interno dell'UE. Si tratta di un endpoint esclusivo per l'UE e non di un'impostazione di località nell'API globale. Per saperne di più, 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 saperne di più su quote e limiti, consulta Quote.

Passaggi successivi

Utilizza Cloud Translation - Advanced per tradurre testo, creare glossari o fare richieste batch.