Endpoint globali e a livello di più aree geografiche
Cloud Translation - Advanced offre un endpoint globale oltre a endpoint a più regioni nell'UE e negli Stati Uniti:
translate.googleapis.com
(globale)translate-eu.googleapis.com
translate-us.googleapis.com
Se utilizzi un endpoint a più aree geografiche, i tuoi dati at-rest e di machine learning rispettano i confini continentali dell'UE o degli Stati Uniti. Questi endpoint multiregionali sono importanti se la località dei dati deve essere controllata per soddisfare i requisiti normativi locali.
Se non specifichi un endpoint, Cloud Translation - Advanced utilizza per impostazione predefinita l'endpoint globale.
Endpoint globali e multiregionali
Quando utilizzi un endpoint multiregionale, esistono alcune differenze rispetto all'utilizzo dell'endpoint globale:
- Le traduzioni del testo che usano modelli AutoML personalizzati non sono supportate. Puoi utilizzare solo il modello NMT preaddestrato.
- La traduzione dei documenti formattati (nota anche come traduzione di documenti) non è supportata
- Le funzionalità diverse da GA (ancora in Anteprima) non sono supportate.
- Le chiamate tramite l'endpoint globale non possono accedere alle risorse create utilizzando un endpoint multiregionale. Analogamente, le chiamate attraverso un endpoint multiregionale non possono accedere alle risorse create utilizzando l'endpoint globale.
Limitazione delle località delle risorse
Gli amministratori dei criteri dell'organizzazione possono limitare le regioni disponibili per le risorse avanzate di Cloud Translation creando un vincolo per le località delle risorse. Se impostato, Cloud Translation - Utenti avanzati sarà in grado di creare risorse solo in una località specifica.
Specifica un endpoint
L'esempio seguente mostra una traduzione del testo che utilizza un endpoint multiregionale. Se utilizzi le librerie client, imposta l'endpoint API come parte delle opzioni client. Per alcuni esempi, consulta la sezione sull'impostazione della località tramite librerie client nella guida all'API Cloud Natural Language.
REST
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud
- ENDPOINT: endpoint a livello di regione, che determina dove si trovano i dati. Ad esempio,
translate-eu.googleapis.com
. - LOCATION: regione in cui vuoi eseguire questa operazione. Devi scegliere una regione all'interno del confine continentale dell'endpoint della regione. Ad
esempio, se utilizzi l'endpoint
translate-eu.googleapis.com
, specifica un'area geografica in Europa comeeurope-west1
.
Metodo e URL HTTP:
POST https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
Corpo JSON richiesta:
{ "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base", "sourceLanguageCode": "en", "targetLanguageCode": "de", "contents": ["Come here!"] }
Per inviare la richiesta, scegli una delle seguenti opzioni:
ricci
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "translations": [ { "translatedText": "Komm her!", "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base" } ] }