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 consulta l'articolo Confronto di base e avanzato.

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

Migrazione ad Advanced

I passaggi seguenti descrivono le azioni necessarie per aggiornare le tue impostazioni per le applicazioni dall'utilizzo di Cloud Translation - Basic a Cloud Translation - Advanced.

1. Fai un inventario dei progetti, delle applicazioni e degli utenti Google Cloud che accedere 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 verso Cloud Translation - Advanced non superare 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 alla fatturazione.

Differenze principali tra le versioni 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 dispone di funzionalità che richiedono risorse gestite dal cliente; queste risorse richiedono la gestione del ruolo IAM e delle autorizzazioni. Per questo motivo, non puoi utilizzare le chiavi API per l'autenticazione nel 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 l'account di servizio. Tuttavia, per Cloud Translation - Advanced, le autorizzazioni .

Per concedere agli account di servizio le autorizzazioni per chiamare Cloud Translation - Advanced, devi e assegnare ruoli IAM. Cloud Translation - Advanced offre diverse Ruoli IAM che puoi assegnare al tuo account di servizio per accedere risorse specifiche del tuo 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 Ruoli IAM documentazione.

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, disponibili in a progetti diversi. Ad esempio, potresti avere un progetto centrale che contiene 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 risorse i nomi degli utenti. 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 del resource 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 che invii getSupportedLanguages potrebbe avere il seguente aspetto:

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

Nota: tutte le tue 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 maggiori informazioni per ulteriori informazioni, consulta la sezione Globale e multiregionale endpoint.

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, crea glossari o creare in batch richieste.