Endpoint globali e a livello di più regioni

Cloud Translation - Advanced offre un endpoint globale e endpoint multiregionali per l'UE e gli Stati Uniti:

  • translate.googleapis.com (globale)
  • translate-eu.googleapis.com
  • translate-us.googleapis.com

Se utilizzi un endpoint multiregionale, l'elaborazione dei dati a riposo e del machine learning rimane all'interno dei confini continentali dell'UE o degli Stati Uniti. Questi endpoint multiregionali sono importanti se la posizione dei dati deve essere controllata per rispettare i requisiti normativi locali.

Se non specifichi un endpoint, Cloud Translation - Advanced utilizza per impostazione predefinita l'endpoint globale.

Endpoint globali e a livello di più regioni

Quando utilizzi un endpoint multiregionale, esistono alcune differenze rispetto all'utilizzo dell'endpoint globale:

  • Le traduzioni di testo che utilizzano modelli AutoML personalizzati non sono supportate. Puoi utilizzare solo il modello NMT preaddestrato.
  • Le funzionalità non 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 tramite 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 di Cloud Translation - Advanced creando un vincolo per le località delle risorse. Se impostato, gli utenti di Cloud Translation - Advanced potranno creare risorse solo in una determinata posizione.

Specifica un endpoint

L'esempio seguente mostra una traduzione di testo che utilizza un endpoint con più regioni. Se utilizzi le librerie client, imposta l'endpoint API come parte delle opzioni client. Per alcuni esempi, consulta Impostazione della località utilizzando le librerie client nella guida all'API Cloud Natural Language.

REST

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud
  • ENDPOINT: endpoint a livello di area geografica, che determina la posizione dei dati. Ad esempio, translate-eu.googleapis.com.
  • LOCATION: regione in cui vuoi eseguire questa operazione. Devi selezionare una regione all'interno del confine continentale dell'endpoint regionale. Ad esempio, se utilizzi l'endpoint translate-eu.googleapis.com, specifica una regione in Europa, ad esempio europe-west1.

Metodo HTTP e URL: 

POST https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText

Corpo JSON della 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:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

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, quindi esegui il comando seguente: 

$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"
    }
  ]
}