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 Daten im Ruhezustand 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 gegen multiregionale Endpunkte

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

• Textübersetzungen, die benutzerdefinierte AutoML-Modelle nutzen, werden nicht unterstützt. Sie können nur das vortrainierte NMÜ-Modell verwenden.
• Features, die nicht allgemein verfügbar sind, sich also noch im Vorschaumodus befinden, werden nicht unterstützt.
• Aufrufe über den globalen Endpunkt können nicht auf Ressourcen zugreifen, die mit einem multiregionalen Endpunkt erstellt wurden. Ebenso können Aufrufe über einen multiregionalen Endpunkt 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.

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 mit Clientbibliotheken festlegen.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• 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 Grenzen des regionalen Endpunkts auswählen. Wenn Sie beispielsweise den Endpunkt translate-eu.googleapis.com verwenden, geben Sie eine Region in Europa an, z. B. 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

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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 in etwa folgende JSON-Antwort erhalten:

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