Se usó la API de Cloud Translation para traducir esta página.

Ejecuta una traducción por lotes con el conector de Cloud Translation

En este instructivo, se muestra cómo crear un flujo de trabajo que use el conector de la API de Cloud Translation para traducir archivos a otros idiomas en modo por lotes asíncrono. Esto proporciona un resultado en tiempo real a medida que se procesan las entradas.

Objetivos

En este instructivo, realizarás las siguientes acciones:

Crea un bucket de Cloud Storage de entrada.
Crea dos archivos en inglés y súbelos al bucket de entrada.
Crea un flujo de trabajo que use el conector de la API de Cloud Translation para traducir los dos archivos al francés y al español, y guarda los resultados en un bucket de salida.
Implementa y ejecuta el flujo de trabajo para organizar todo el proceso.

Costos

En este documento, usarás los siguientes componentes facturables de Google Cloud:

Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios. Es posible que los usuarios nuevos de Google Cloud califiquen para obtener una prueba gratuita.

Antes de comenzar

Es posible que las restricciones de seguridad que define tu organización no te permitan completar los siguientes pasos. Para obtener información sobre la solución de problemas, consulta Desarrolla aplicaciones en un entorno de Google Cloud restringido.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

Create or select a Google Cloud project.

Create a Google Cloud project:
```
gcloud projects create PROJECT_ID
```
Replace PROJECT_ID with a name for the Google Cloud project you are creating.
Select the Google Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
Replace PROJECT_ID with your Google Cloud project name.

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Storage, Translation, and Workflows APIs:

gcloud services enable storage.googleapis.com translate.googleapis.com workflows.googleapis.com

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

Create or select a Google Cloud project.

Create a Google Cloud project:
```
gcloud projects create PROJECT_ID
```
Replace PROJECT_ID with a name for the Google Cloud project you are creating.
Select the Google Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
Replace PROJECT_ID with your Google Cloud project name.

Make sure that billing is enabled for your Google Cloud project.

Enable the Cloud Storage, Translation, and Workflows APIs:

gcloud services enable storage.googleapis.com translate.googleapis.com workflows.googleapis.com

Actualiza los componentes de gcloud:
```
gcloud components update
```

Accede con tu cuenta:
```
gcloud auth login
```
Establece la ubicación predeterminada que se usa en este instructivo:
```
gcloud config set workflows/location us-central1
```
Como este instructivo usa el modelo predeterminado de AutoML Translation que reside en us-central1, debes establecer la ubicación en us-central1.

Si usas un modelo o un glosario de AutoML Translation que no sea el predeterminado, asegúrate de que resida en la misma ubicación que la llamada al conector. De lo contrario, se muestra un error INVALID_ARGUMENT (400). Para obtener más información, consulta el método batchTranslateText.

Crea un bucket y archivos de Cloud Storage de entrada

Puedes usar Cloud Storage para almacenar objetos. Los objetos son datos inmutables que constan de un archivo de cualquier formato y se almacenan en contenedores llamados buckets.

Crea un bucket de Cloud Storage para almacenar los archivos que deseas traducir:

BUCKET_INPUT=${GOOGLE_CLOUD_PROJECT}-input-files
gcloud storage buckets create gs://${BUCKET_INPUT}

Crea dos archivos en inglés y súbelos al bucket de entrada:

echo "Hello World!" > file1.txt
gcloud storage cp file1.txt gs://${BUCKET_INPUT}
echo "Workflows connectors simplify calling services." > file2.txt
gcloud storage cp file2.txt gs://${BUCKET_INPUT}

Implementa y ejecuta el flujo de trabajo

Un flujo de trabajo está compuesto por una serie de pasos descritos con la sintaxis de Workflows, que se pueden escribir en formato YAML o JSON. Esta es la definición del flujo de trabajo. Después de crear un flujo de trabajo, debes implementarlo para que esté disponible para su ejecución.

Crea un archivo de texto con el nombre de archivo workflow.yaml y con el siguiente contenido:

main:
  steps:
  - init:
      assign:
      - projectId: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
      - location: ${sys.get_env("GOOGLE_CLOUD_LOCATION")}
      - inputBucketName: ${projectId + "-input-files"}
      - outputBucketName: ${projectId + "-output-files-" + string(int(sys.now()))}
  - createOutputBucket:
        call: googleapis.storage.v1.buckets.insert
        args:
          project: ${projectId}
          body:
            name: ${outputBucketName}
  - batchTranslateText:
      call: googleapis.translate.v3beta1.projects.locations.batchTranslateText
      args:
          parent: ${"projects/" + projectId + "/locations/" + location}
          body:
              inputConfigs:
                gcsSource:
                  inputUri: ${"gs://" + inputBucketName + "/*"}
              outputConfig:
                  gcsDestination:
                    outputUriPrefix: ${"gs://" + outputBucketName + "/"}
              sourceLanguageCode: "en"
              targetLanguageCodes: ["es", "fr"]
      result: batchTranslateTextResult

El flujo de trabajo asigna variables, crea un bucket de salida e inicia la traducción de los archivos, y guarda los resultados en el bucket de salida.

Después de crear el flujo de trabajo, impleméntalo:

gcloud workflows deploy batch-translation --source=workflow.yaml

Ejecuta el flujo de trabajo:

gcloud workflows execute batch-translation

Para ver el estado del flujo de trabajo, puedes ejecutar el comando que se muestra. Por ejemplo:
```
gcloud workflows executions describe eb4a6239-cffa-4672-81d8-d4caef7d8424 /
  --workflow batch-translation /
  --location us-central1
```
El flujo de trabajo debe ser ACTIVE. Después de unos minutos, los archivos traducidos (en francés y español) se suben al bucket de salida.

Cómo crear una lista de objetos en el bucket de salida

Para confirmar que el flujo de trabajo funcionó como se esperaba, enumera los objetos en el bucket de salida.

Recupera el nombre de tu bucket de salida:

gcloud storage ls

El resultado es similar a este:

gs://PROJECT_ID-input-files/
gs://PROJECT_ID-output-files-TIMESTAMP/

Haz una lista de los objetos de tu bucket de salida:
```
gcloud storage ls gs://PROJECT_ID-output-files-TIMESTAMP/** --recursive
```
Después de unos minutos, aparecerán los archivos traducidos, dos de cada uno en francés y español.

Realiza una limpieza

Si creaste un proyecto nuevo para este instructivo, bórralo. Si usaste un proyecto existente y deseas conservarlo sin los cambios que se agregaron en este instructivo, borra los recursos creados para el instructivo.

Borra el proyecto

La manera más fácil de eliminar la facturación es borrar el proyecto que creaste para el instructivo.

Para borrar el proyecto, haz lo siguiente:

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

Se borra todo en el proyecto. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varias infraestructuras, instructivos y guías de inicio rápido la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

Elimina recursos de instructivos

Quita la configuración predeterminada de gcloud que agregaste durante la configuración del instructivo:
```
gcloud config unset workflows/location
```
Borra el flujo de trabajo que se creó en este instructivo:
```
gcloud workflows delete WORKFLOW_NAME
```
Borra los buckets que creaste en este instructivo:

Advertencia: El siguiente comando también borra todos los objetos almacenados en el bucket. Estos objetos no se pueden recuperar.
```
gcloud storage rm gs://BUCKET_NAME --recursive
```
En el ejemplo anterior, BUCKET_NAME es el nombre del bucket que se borrará. Por ejemplo, my-bucket

La respuesta es similar al ejemplo a continuación:
```
Removing gs://my-bucket/...
```
Nota: Si tienes que borrar una gran cantidad de objetos en tus buckets, evita usar gcloud CLI, ya que la operación tarda mucho tiempo en completarse. En su lugar, usa la consola de Google Cloud o la Administración del ciclo de vida de los objetos.

¿Qué sigue?

Para obtener más información sobre Workflows, consulta Comprende Workflows.
Para obtener más información sobre la sintaxis de Workflows, consulta la Referencia de la sintaxis de Workflows.
Para obtener más información sobre los conectores de Workflows, consulta Descripción de los conectores.