Especifica un extremo regional

Cloud Translation Advanced ofrece un extremo de API regional para la UE. Si usas el extremo regional, tus datos en reposo permanecerán dentro de los límites continentales de la UE. Especificar un extremo es importante si se debe controlar la ubicación de tus datos para cumplir con los requisitos reglamentarios locales. El extremo de la API regional de la UE de Cloud Translation Advanced es translate-eu.googleapis.com

Existen algunas diferencias cuando se usa el extremo de la API regional de la UE en comparación con el uso del extremo global (translate.googleapis.com):

  • No se admiten traducciones de texto que usen modelos personalizados de AutoML. Solo puedes usar el modelo de NMT previamente entrenado.
  • Las traducciones por lotes no son compatibles.
  • No se admiten las funciones que no son de disponibilidad general (todavía en Vista previa), como Document Translation.
  • Las llamadas que se realizan a través del extremo global no pueden acceder a los recursos que se crearon mediante el extremo de la UE, que tiene una ubicación de europe-west1. Del mismo modo, las llamadas a través del extremo de la UE 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.

Ejemplo de uso

En el siguiente ejemplo, se muestra una traducción de texto que usa un extremo regional. 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.

LÍNEA DE REST Y CMD

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

  • PROJECT_NUMBER_OR_ID: el número o ID de tu 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 application-default print-access-token) \
-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 application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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