Extremos globales y multirregionales

Cloud Translation Advanced ofrece un extremo global, además de los extremos multirregión de la UE y EE.UU.:

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

Si usas un extremo multirregional, tus datos en reposo y procesamiento de aprendizaje automático permanecen dentro de los límites continentales de la UE o de EE.UU. Estos extremos multirregión son importantes si la ubicación de tus datos debe controlarse para cumplir con los requisitos reglamentarios locales.

Si no especificas un extremo, Cloud Translation Advanced usa el extremo global de forma predeterminada.

Extremos globales en comparación con multirregionales

Cuando se usa un extremo multirregional, hay algunas diferencias en comparación con el uso del extremo global:

  • No se admiten traducciones de texto que usen modelos personalizados de AutoML. Solo puedes usar el modelo de NMT previamente entrenado.
  • No se admite la traducción de documentos con formato (también conocidos como traducciones de documentos)
  • No se admiten las funciones que no son de disponibilidad general (todavía en Vista previa).
  • Las llamadas a través del extremo global no pueden acceder a los recursos que se crearon mediante un extremo multirregional. Del mismo modo, las llamadas a través de un extremo multirregional no pueden acceder a los recursos que se crearon mediante el extremo global.

Restringir las ubicaciones de recursos

Los administradores de políticas de la organización pueden restringir las regiones disponibles para los recursos de Cloud Translation Advanced mediante la creación de una restricción de ubicaciones de recursos. Si se establece, los usuarios de Cloud Translation Advanced podrían crear recursos solo en una ubicación en particular.

Especifica un extremo

En el siguiente ejemplo, se muestra una traducción de texto que usa un extremo multirregional. Si usas las bibliotecas cliente, establece el extremo de la API como parte de las opciones del cliente. Para ver algunos ejemplos, consulta Configura la ubicación con bibliotecas cliente en la guía de la API de Cloud Natural Language.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_NUMBER_OR_ID: el ID numérico o alfanumérico del proyecto de Google Cloud
  • ENDPOINT: extremo regional, que determina dónde residen tus datos Por ejemplo, translate-eu.googleapis.com
  • LOCATION: la región en la que deseas ejecutar esta operación Debes elegir una región que esté dentro del límite continental del extremo regional. Por ejemplo, si usas el extremo translate-eu.googleapis.com, especifica una región en Europa, como europe-west1.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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