Migrazione ad Advanced da Basic

Cloud Translation - Utenti esistenti di base (v2) che vogliono utilizzare la versione più recente le funzionalità di Cloud Translation, come i glossari e i modelli AutoML, devono eseguire la migrazione delle applicazioni per 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 illustrano 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 servizi e aggiornarli in modo che utilizzino le librerie client avanzate di Cloud Translation.
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 per i modelli AutoML con Cloud Translation - Advanced, devi abilitare AutoML. Per ulteriori informazioni, consulta Guida alla configurazione
5. Utilizza librerie e metodi client Cloud Translation - Advanced. Per Richieste avanzate per Cloud Translation, devi includere il numero del progetto (o ID) e 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 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 seguenti sezioni descrivono le chiavi differenze tra le versioni Advanced e Basic.

Account di servizio

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

Cloud Translation - Advanced include 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 gli account di servizio per l'autenticazione Cloud Translation - Avanzato.

Per ulteriori informazioni, consulta la guida alla configurazione.

Ruoli IAM

Quando utilizzi gli account di servizio per Cloud Translation - Basic, gli account di servizio 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 account di servizio per tradurre il testo, devi assegnare roles/cloudtranslate.user ruolo. Per ulteriori informazioni, consulta i ruoli IAM in Cloud Translation - Dettagli avanzati.

Se prevedi di utilizzare i modelli AutoML o qualsiasi funzionalità che si basa su in Cloud Storage, devi includere anche i ruoli appropriati i servizi di machine learning. 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 di traduzione automatica neurale (NMT). Per Cloud Translation - Advanced, puoi utilizzare il modello NMT preaddestrato o un AutoML Translation personalizzato.

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. Account di servizio in il progetto o altri progetti possono utilizzare questi modelli, ma richiedono le autorizzazioni per farlo.

Per ulteriori informazioni sui modelli di traduzione, consulta la sezione Traduzione testo (avanzato).

Librerie client

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

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 i suoi location, che specifica dove viene eseguita la richiesta. Ad esempio, il nome di un Il modello AutoML è un nome risorsa.

Se il nome del tuo progetto Google Cloud è my-project e la località della risorsa è us-central1, quindi il nome completo delle risorse potrebbe essere il 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, solo global e us-central1 località sono supportate. Per tutti e risorse personalizzate: modelli AutoML, glossari operazioni a lunga esecuzione: devi usare us-central1. Puoi anche utilizzare us-central1 quando utilizzi modelli di traduzione generici e il rilevamento della lingua. Puoi utilizzare la posizione global solo quando usi modelli di traduzione generici e rilevamento della lingua.

Cloud Translation - Advanced fornisce inoltre endpoint multiregionali, come translate-eu.googleapis.com per garantire il trattamento dei dati all'interno dell'UE. Si tratta di un un endpoint univoco per l'UE e non un'impostazione di località sull'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 saperne di più su quote e limiti, consulta Quote.

Passaggi successivi

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