Configuración

Para empezar a usar Cloud Translation, necesitas un proyecto que tenga habilitada la API Cloud Translation y credenciales para hacer llamadas autenticadas. En las siguientes secciones se explica cómo configurar la API Cloud Translation antes de hacer tu primera llamada.

El proceso de configuración implica usar la Google Cloud consola, que es una interfaz web que puedes usar para aprovisionar, configurar, gestionar y monitorizar sistemas enGoogle Cloud. Si no has usado la Google Cloud consola antes, consulta la página Consola de Cloud para obtener más información.

Antes de empezar

Cloud Translation está disponible en dos ediciones (Básica y Avanzada). Decide qué edición vas a usar, ya que cada una tiene su propio conjunto de bibliotecas de cliente.

Crea o escoge un proyecto.

Para usar los servicios que ofrece Google Cloud, debes crear un proyecto. Un proyecto organiza todos tus Google Cloud recursos. Un proyecto consta de un conjunto de colaboradores, APIs habilitadas (y otros recursos), herramientas de monitorización, información de facturación y controles de autenticación y acceso. Puedes crear un proyecto o varios y usarlos para organizar tus Google Cloud recursos en una jerarquía de recursos. Cuando crees un proyecto, anota el ID del proyecto. Necesitará este ID para hacer llamadas a la API. Para obtener más información sobre los proyectos, consulta la documentación de Resource Manager.

Te recomendamos que crees proyectos independientes para los experimentos, las pruebas y la producción. Después de crear un proyecto, anota el número o el ID del proyecto. Debes proporcionar el número (o el ID) del proyecto cuando hagas llamadas a la API Cloud Translation.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Habilita la facturación

Para usar Cloud Translation, debes habilitar la facturación. Para obtener más información sobre los precios de Cloud Translation, consulta la página de precios.

Nota: Para ayudarte a gestionar tu presupuesto, puedes definir límites de uso en tus proyectos. Para obtener más información, consulta Definir cuotas de uso.

Una cuenta de facturación se usa para definir quién paga un conjunto de recursos determinado y se puede vincular a uno o varios proyectos. El uso del proyecto se carga en la cuenta de facturación vinculada. En la mayoría de los casos, la facturación se configura al crear un proyecto. Para obtener más información, consulta la documentación de facturación.

Verify that billing is enabled for your Google Cloud project.

Habilitar la API

Debes habilitar la API Cloud Translation en tu proyecto. Para obtener más información sobre cómo habilitar APIs, consulta la documentación de Uso de Servicio.

Enable the Cloud Translation API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Definir cuotas de uso

Cloud Translation tiene un sistema de gestión de cuotas para ayudarte a ti y a Google a gestionar el uso del servicio. De forma predeterminada, el número de caracteres que puedes enviar al día es ilimitado. Si tienes un presupuesto definido, te recomendamos que monitorices tu uso diario y ajustes las cuotas según el gasto que tengas previsto.

Para obtener más información sobre las cuotas, consulta Cuotas y límites.

Configurar la autenticación

Si tienes previsto usar la API Cloud Translation, debes configurar la autenticación. Cualquier aplicación cliente que use la API debe autenticarse y tener acceso a los recursos solicitados. Para obtener más información, consulta Autenticarse en Cloud Translation.

Roles de Gestión de Identidades y Accesos

Cuando una entidad principal (cuenta de usuario, cuenta de servicio, etc.) llama a una API,Google Cloud requiere que la entidad principal tenga los permisos adecuados. Puedes conceder permisos asignando roles a una entidad principal. Para obtener más información, consulta Controlar el acceso con la gestión de identidades y accesos.

Nota: Los permisos de rol solo se aplican a Cloud Translation Advanced. Aunque puedes usar cuentas de servicio en ambas ediciones, solo puedes definir permisos específicos para Cloud Translation Advanced. En Cloud Translation - Basic, puedes hacer cualquier solicitud independientemente de los permisos de la cuenta de servicio.

Instalar bibliotecas de cliente

Las bibliotecas de cliente están disponibles en varios lenguajes populares. Te recomendamos que uses estas bibliotecas de cliente para hacer llamadas a Cloud Translation, ya que facilitan el acceso a las APIs. Si una biblioteca de cliente no se ajusta a tus necesidades o no está disponible en tu idioma, crea tu propio código personalizado. Para obtener más información, consulta Usar tu propio código de cliente.

Por ejemplo, cuando usas una biblioteca cliente, puede determinar tus credenciales de forma implícita a través de la variable de entorno GOOGLE_APPLICATION_CREDENTIALS. No es necesario que especifiques explícitamente tus credenciales en el código. Para obtener más información, consulta la sección Bibliotecas de cliente explicadas de la documentación de las APIs de Cloud.

Bibliotecas de cliente de Cloud Translation - Basic

Selecciona el lenguaje de programación que vas a utilizar y, a continuación, ejecuta el comando relacionado. Para obtener más información, consulta la descripción general de las bibliotecas de cliente de Cloud Translation Basic.

C#

nuget install Google.Cloud.Translation.V2

Go

go get cloud.google.com/go/translate

Java

Precaución: La biblioteca cliente de Java no es compatible con Android.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.67.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

If you are using Gradle, add the following to your dependencies:

implementation 'com.google.cloud:google-cloud-translate:2.73.0'

If you are using sbt, add the following to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.73.0"

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

Node.js

Para obtener más información sobre cómo configurar tu entorno de desarrollo de Node.js, consulta la guía de configuración del entorno de desarrollo de Node.js.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Para obtener más información sobre cómo configurar tu entorno de desarrollo de Python, consulta la guía de configuración del entorno de desarrollo de Python.

pip install google-cloud-translate==2.0.1

Ruby

Para obtener más información sobre cómo configurar tu entorno de desarrollo de Ruby, consulta la guía de configuración del entorno de desarrollo de Ruby.

gem install google-cloud-translate-v2

Bibliotecas de cliente de Cloud Translation - Advanced

Selecciona el lenguaje de programación que vas a utilizar y, a continuación, ejecuta el comando relacionado. Para obtener más información, consulta la descripción general de las bibliotecas de cliente de Cloud Translation Advanced.

C#

nuget install Google.Cloud.Translate.V3 -Pre

Go

go get cloud.google.com/go/translate/apiv3

Java

Precaución: La biblioteca cliente de Java no es compatible con Android.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.67.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

If you are using Gradle, add the following to your dependencies:

implementation 'com.google.cloud:google-cloud-translate:2.73.0'

If you are using sbt, add the following to your dependencies:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.73.0"

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

Node.js

Para obtener más información sobre cómo configurar tu entorno de desarrollo de Node.js, consulta la guía de configuración del entorno de desarrollo de Node.js.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Para obtener más información sobre cómo configurar tu entorno de desarrollo de Python, consulta la guía de configuración del entorno de desarrollo de Python.

pip install --upgrade google-cloud-translate

Ruby

Para obtener más información sobre cómo configurar tu entorno de desarrollo de Ruby, consulta la guía de configuración del entorno de desarrollo de Ruby.

gem install google-cloud-translate

Instalar Google Cloud CLI

Nota: Puedes omitir este paso si no vas a usar la línea de comandos para hacer llamadas a la API autenticadas.

Si tienes previsto enviar solicitudes a Cloud Translation a través de la línea de comandos (por ejemplo, con comandos curl), instala e inicializa gcloud CLI, que se incluye en Google Cloud CLI. En el siguiente enlace encontrará más información:

Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:

gcloud init

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Probar el SDK y la autenticación

Si has configurado la variable de entorno GOOGLE_APPLICATION_CREDENTIALS, puedes usar gcloud para probar tu entorno de autenticación. Ejecuta el siguiente comando y comprueba que no se produce ningún error y que se devuelven las credenciales:

gcloud auth application-default print-access-token

Todos los ejemplos de REST de línea de comandos de Cloud Translation usan el comando anterior para autenticar las llamadas a la API.

Siguientes pasos

• Prueba las guías de inicio rápido para hacer llamadas con traducción sencillas:

  • Guía de inicio rápido de Cloud Translation Basic
  • Guía de inicio rápido de Cloud Translation Advanced

• Consulta las guías prácticas para obtener más información sobre cómo usar las distintas funciones de Cloud Translation.

Pruébalo

Si es la primera vez que utilizas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Translation en situaciones reales. Los nuevos clientes también reciben 300 USD en crédito gratuito para ejecutar, probar y desplegar cargas de trabajo.

Probar Cloud Translation gratis