Guía de inicio rápido (básico)

En esta página, se muestra cómo realizar una solicitud a Cloud Translation básico (v2) con curl.

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. Configura un proyecto de Cloud Console.

    Configurar un proyecto

    Haz clic para realizar alguna de las siguientes acciones:

    • Crea o selecciona un proyecto.
    • Habilita la API de Cloud Translation para ese proyecto.
    • Crea una cuenta de servicio.
    • Descargar una clave privada como JSON

    Puedes ver y administrar estos recursos en cualquier momento desde Cloud Console.

  3. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo JSON que contiene la clave de tu cuenta de servicio. Esta variable solo se aplica a la sesión actual de shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

  4. Instala e inicializa el SDK de Cloud.

Realiza una solicitud a la API de Translation

Realiza una solicitud a la API de Translation con una llamada del método REST al método de traducción v2.

  1. Usa curl para realizar una solicitud al extremo https://translation.googleapis.com/language/translate/v2.

    El comando curl incluye JSON con el texto que se traducirá (q), el idioma desde el que se traducirá (source) y el idioma al que se traducirá (target).

    Los idiomas fuente y objetivo se identifican mediante los códigos ISO-639-1. El idioma fuente es inglés (en) y el idioma objetivo es español (es). El formato de la consulta se indica como “texto” para el texto sin formato.

    El comando curl de muestra usa el comando gcloud auth application-default print-access-token para obtener un token de autenticación.

    curl -s -X POST -H "Content-Type: application/json" \
        -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
        --data "{
      'q': 'The Great Pyramid of Giza (also known as the Pyramid of Khufu or the
            Pyramid of Cheops) is the oldest and largest of the three pyramids in
            the Giza pyramid complex.',
      'source': 'en',
      'target': 'es',
      'format': 'text'
    }" "https://translation.googleapis.com/language/translate/v2"
      

    Deberías ver una respuesta similar a la siguiente:

    {
      "data": {
        "translations": [
          {
            "translatedText": "La Gran Pirámide de Giza (también conocida como la
             Pirámide de Khufu o la Pirámide de Keops) es la más antigua y más
             grande de las tres pirámides en el complejo de la pirámide de Giza."
          }
        ]
      }
    }
    
      

Felicitaciones. Enviaste tu primera solicitud a la API de Translation.

Instala la biblioteca cliente de Cloud Translation básico

Las bibliotecas cliente están disponibles para varios lenguajes populares, y estas son las opciones recomendadas. Para instalar una biblioteca cliente, haz lo siguiente:

C#

nuget install Google.Cloud.Translation.V2

Go

go get -u cloud.google.com/go/translate

Java

Si usas Maven, agrega lo siguiente al archivo pom.xml. Para obtener más información sobre las BOM, consulta Las bibliotecas de BOM de Google Cloud Platform.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>10.1.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>

Si usas Gradle, agrega lo siguiente a las dependencias:

compile 'com.google.cloud:google-cloud-translate:1.95.2'

Si usas sbt, agrega lo siguiente a las dependencias:

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

Si usas IntelliJ o Eclipse, puedes agregar bibliotecas cliente a tu proyecto mediante los siguientes complementos de IDE:

Los complementos brindan funcionalidades adicionales, como administración de claves para las cuentas de servicio. Consulta la documentación de cada complemento para obtener más detalles.

Node.js

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

npm install --save @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Para obtener más información sobre la configuración de 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 la configuración de tu entorno de desarrollo de Ruby, consulta la guía de configuración del entorno de desarrollo de Ruby.

gem install google-cloud-translate

Ve a Bibliotecas cliente de Translation para obtener instrucciones de instalación.

Realiza una limpieza

Para evitar cargos innecesarios de Google Cloud, usa Cloud Console a fin de borrar tu proyecto si no lo necesitas.

Próximos pasos