Romaniza texto

La romanización convierte una secuencia de comandos que no está en lengua latina en una secuencia de comandos en lengua latina. La secuencia de comandos en lengua latina se basa en la pronunciación del idioma de origen. Por ejemplo, Cloud Translation romaniza los siguientes caracteres japoneses こんにちは世界 en Kon'nichiwa sekai.

Para ver qué idiomas pueden romanizarse, consulta Idiomas admitidos.

Antes de comenzar

Antes de empezar a usar la API de Cloud Translation, debes tener un proyecto con esta API habilitada y las credenciales adecuadas. También puedes instalar bibliotecas cliente para los lenguajes de programación comunes que te ayudarán a hacer llamadas a la API. Para obtener más información, consulta la página Configuración.

Romaniza texto

REST

Usa el método romanizeText para convertir una secuencia de comandos que no está en lengua latina a una secuencia de comandos en lengua latina.

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

PROJECT_NUMBER_OR_ID: Es el ID numérico o alfanumérico de tu proyecto de Google Cloud .
LOCATION: Es la región en la que deseas ejecutar esta operación. Por ejemplo: us-central1
SOURCE_LANGUAGE: Es el código de idioma del documento de entrada.
SOURCE_TEXT: Es el texto en el idioma de origen que se romanizará.

Método HTTP y URL:

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText

Cuerpo JSON de la solicitud:

{
  "source_language_code": "SOURCE_LANGUAGE",
  "contents": "SOURCE_TEXT"
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:romanizeText" | Select-Object -Expand Content

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

{
  "romanizations": [
    {
      "romanizedText": "ROMANIZED_TEXT"
    }
  ]
}

¿Qué sigue?

El precio de la romanización es por carácter enviado. Para obtener más información, consulta Precios.