Esegui la migrazione ad Avanzate da base

Gli utenti esistenti di Cloud Translation - Basic (v2) che vogliono utilizzare le funzionalità più recenti di Cloud Translation, come glossari e modelli AutoML, devono eseguire la migrazione delle proprie applicazioni per utilizzare Cloud Translation - Advanced (v3). Per un confronto, vedi la pagina Confronto tra di base e avanzata.

La migrazione alla versione Advanced include l'utilizzo di Identity and Access Management (IAM) e le 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 seguenti passaggi descrivono le azioni necessarie per aggiornare le applicazioni esistenti dall'utilizzo di Cloud Translation - Basic - Cloud Translation - Advanced.

1. Acquisisci l'inventario dei tuoi progetti, applicazioni e utenti Google Cloud che accedono all'API Cloud Translation - Basic. Dovrai fornire account di servizio e aggiornarli per utilizzare le librerie client avanzate di Cloud Translation.
2. Configura gli account di servizio e l'autenticazione per l'applicazione.
3. Utilizza i ruoli IAM per impostare le autorizzazioni per gli account di servizio.
4. Abilita Cloud Translation - Advanced per il tuo progetto. Se utilizzi i modelli AutoML con Cloud Translation - Advanced, devi abilitare anche AutoML. Per ulteriori informazioni, consulta la guida sulla configurazione
5. Utilizzo di Cloud Translation - Librerie e metodi client avanzati. Per Cloud Translation - Richieste avanzate, devi includere il numero del progetto (o l'ID progetto) e la posizione del progetto, ad esempio global o us-central1.
6. Verifica che le dimensioni delle richieste di traduzione in 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 le potenziali modifiche nella fatturazione.

Differenze principali tra avanzate e di base

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

Account di servizio

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

Cloud Translation - Advanced dispone di funzionalità che richiedono risorse gestite dal cliente. Queste risorse richiedono il ruolo IAM e la gestione delle autorizzazioni. Per questo motivo, non puoi utilizzare le chiavi API per autenticarti nel servizio. Devi invece utilizzare gli account di servizio per l'autenticazione a Cloud Translation - Advanced.

Per ulteriori informazioni, consulta la guida alla configurazione.

Ruoli IAM

Quando utilizzi gli account di servizio per Cloud Translation - Basic, vengono utilizzati solo per l'autenticazione. Puoi effettuare chiamate 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, assegna loro i ruoli IAM. Cloud Translation - Advanced ha diversi ruoli IAM che puoi assegnare al tuo account di servizio per accedere a risorse specifiche nel progetto. Ad esempio, se vuoi utilizzare il tuo account di servizio per tradurre il testo, assegnagli il ruolo roles/cloudtranslate.user. Per ulteriori informazioni, consulta i ruoli IAM in Cloud Translation - Dettagli avanzati.

Se prevedi di utilizzare modelli AutoML o qualsiasi funzionalità che si basi su Cloud Storage, devi includere anche i ruoli appropriati per tali servizi. Per visualizzare un elenco di tutti i ruoli IAM, consulta la documentazione sui ruoli IAM.

Modelli di traduzione

Quando richiedi una traduzione utilizzando Cloud Translation - Basic, Google utilizza un modello preaddestrato di Neural Machine Translation (NMT). Per Cloud Translation - Advanced, puoi utilizzare il modello NMT preaddestrato o un modello personalizzato 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 essere individuati in progetti diversi. Ad esempio, potresti avere un progetto centrale che contiene i tuoi modelli di traduzione per semplificare la manutenzione e la fatturazione. Gli account di servizio nel progetto o in altri progetti possono utilizzare questi modelli, ma per farlo sono necessarie le autorizzazioni necessarie.

Per scoprire di più sui modelli di traduzione, consulta la sezione Traduzione di testo (avanzata).

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 nomi delle risorse. Per ulteriori informazioni, consulta la panoramica di Cloud Translation - Advanced client librerie o prova la guida rapida per il testo di traduzione (edizione avanzata).

Risorse, progetti e località

Richieste a Cloud Translation - Avanzate richiedono il nome della risorsa da utilizzare. In genere una risorsa è un nome qualificato che include il nome del progetto e la sua posizione, che specifica dove viene eseguita la richiesta. Ad esempio, il nome di un modello AutoML è un nome di risorsa.

Se il progetto Google Cloud ha il nome my-project e la località della risorsa è us-central1, il nome completo delle risorse potrebbe essere simile al seguente:

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

L'URL che invii per 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 un'unica richiesta a Cloud Translation - Advanced devono avere la stessa località. Attualmente 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 usi modelli di traduzione generali e il rilevamento della lingua. Puoi utilizzare la località global solo quando utilizzi i 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. Questo è un endpoint univoco per l'UE e non un'impostazione di località sull'API globale. Per saperne di più, consulta Endpoint globali e a livello di più aree geografiche.

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 sulle quote e i limiti, consulta Quote.

Passaggi successivi

Utilizza Cloud Translation - Avanzato per tradurre il testo, creare glossari o effettuare richieste batch.