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 come europe-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"
    }
  ]
}