Globale und multiregionale Endpunkte

Cloud Translation Advanced bietet einen globalen Endpunkt sowie multiregionale EU- und US-Endpunkte:

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

Wenn Sie einen multiregionalen Endpunkt verwenden, bleiben Ihre ruhenden Daten und die Verarbeitung für maschinelles Lernen innerhalb der kontinentalen Grenzen der EU oder der USA. Diese multiregionalen Endpunkte sind wichtig, wenn der Standort Ihrer Daten lokalen gesetzlichen Anforderungen genügen muss.

Wenn Sie keinen Endpunkt angeben, verwendet Cloud Translation Advanced standardmäßig den globalen Endpunkt.

Globale und multiregionale Endpunkte im Vergleich

Bei der Verwendung eines multiregionalen Endpunkts gibt es einige Unterschiede im Vergleich zur Verwendung des globalen Endpunkts:

  • Textübersetzungen, für die benutzerdefinierte AutoML-Modelle genutzt werden, werden nicht unterstützt. Sie können nur das vortrainierte NMÜ-Modell verwenden.
  • Features, die nicht allgemein verfügbar sind und allenfalls als Vorabversion vorliegen, werden nicht unterstützt.
  • Aufrufe über den globalen Endpunkt können nicht auf Ressourcen zugreifen, die mit einem multiregionalen Endpunkt erstellt wurden. Aufrufe über einen multiregionalen Endpunkt können nicht auf Ressourcen zugreifen, die mit dem globalen Endpunkt erstellt wurden.

Ressourcenstandorte einschränken

Administratoren von Organisationsrichtlinien können die für Cloud Translation Advanced-Ressourcen verfügbaren Regionen durch Erstellen einer Beschränkung für Ressourcenstandorte einschränken. Wenn dies festgelegt ist, können Nutzer von Cloud Translation Advanced nur an einem bestimmten Standort Ressourcen erstellen.

Nutzung globaler API-Endpunkte einschränken

Um die Verwendung regionaler Endpunkte zu erzwingen, können Administratoren für Organisationsrichtlinien die Einschränkung der Organisationsrichtlinie constraints/gcp.restrictEndpointUsage verwenden, um Anfragen an den globalen API-Endpunkt zu blockieren. Weitere Informationen finden Sie unter Endpunktnutzung einschränken.

Endpunkt angeben

Das folgende Beispiel zeigt eine Textübersetzung, die einen multiregionalen Endpunkt verwendet. Wenn Sie die Clientbibliotheken nutzen, legen Sie den API-Endpunkt bei den Clientoptionen fest. Beispiele dazu finden Sie in der Cloud Natural Language API-Anleitung unter Standort mithilfe von Clientbibliotheken festlegen.

REST

Bevor Sie die Anfragedaten verwenden, ersetzen Sie folgende Werte:

  • PROJECT_NUMBER_OR_ID: die numerische oder alphanumerische ID Ihres Google Cloud -Projekts
  • ENDPOINT: der regionale Endpunkt, der festlegt, wo sich Ihre Daten befinden. Beispiel: translate-eu.googleapis.com
  • LOCATION: die Region, in der Sie diesen Vorgang ausführen möchten. Sie müssen dafür eine Region innerhalb der kontinentalen Grenzen des regionalen Endpunkts auswählen. Wenn Sie beispielsweise den Endpunkt translate-eu.googleapis.com verwenden, geben Sie eine Region in Europa an. Beispiel: europe-west1

HTTP-Methode und URL: 

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

JSON-Text der Anfrage:

{
  "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base",
  "sourceLanguageCode": "en",
  "targetLanguageCode": "de",
  "contents": ["Come here!"]
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus: 

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "translations": [
    {
      "translatedText": "Komm her!",
      "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base"
    }
  ]
}