Guia de início rápido (Basic)

Nesta página, você vê como fazer uma solicitação à Cloud Translation – Basic (v2) com o curl.

Antes de começar

  1. Faça login na sua conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. Configure um projeto do Console do Cloud.

    Configurar um projeto

    Clique para:

    • Crie ou selecione um projeto.
    • ativar a API Cloud Translation para esse projeto;
    • criar uma conta de serviço;
    • fazer o download de uma chave privada como JSON.

    É possível visualizar e gerenciar esses recursos a qualquer momento no Console do Cloud.

  3. Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo JSON que contém a chave da conta de serviço. Essa variável só se aplica à sessão de shell atual. Dessa maneira, se você abrir uma nova sessão, defina a variável novamente.

  4. Instale e inicialize o SDK do Cloud..

Fazer uma solicitação à API Translation

Para fazer uma solicitação à API Translation, realize uma chamada REST para o método de tradução v2.

  1. Use curl para fazer uma solicitação para o endpoint https://translation.googleapis.com/language/translate/v2.

    O comando curl inclui JSON com o texto a ser traduzido (q), além do idioma de origem (source) e de chegada (target).

    Os idiomas de origem e de chegada são identificados com os códigos ISO-639-1. No exemplo, o idioma de origem é o inglês (en) e o idioma de chegada é o espanhol (es). O formato da consulta é referido como “text” em texto simples.

    O comando de amostra curl usa o gcloud auth application-default print-access-token para receber um token de autenticação.

    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"
      

    Uma resposta semelhante a esta será exibida:

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

Parabéns! Você enviou sua primeira solicitação para a API Cloud Translation.

Instalar a biblioteca de cliente da Cloud Translation – Basic

As bibliotecas de cliente estão disponíveis para várias linguagens conhecidas. Estas são as opções recomendadas. Para instalar uma biblioteca de cliente:

C#

nuget install Google.Cloud.Translation.V2

Go

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

Java

Se você estiver usando o Maven, adicione o código abaixo ao arquivo pom.xml. Para mais informações sobre BOMs, consulte BOM das bibliotecas do Google Cloud Platform.

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

Se você estiver usando o Gradle, adicione isto às dependências:

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

Se você estiver usando o sbt, adicione o seguinte às suas dependências:

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

Caso você esteja usando o IntelliJ ou o Eclipse, poderá adicionar bibliotecas de cliente ao seu projeto usando estes plug-ins de ambiente de desenvolvimento integrado:

Os plug-ins também oferecem outras funcionalidades, como gerenciamento de chaves de contas de serviço. Consulte a documentação de cada plug-in para mais detalhes.

Node.js

Para mais informações sobre a configuração do ambiente de desenvolvimento do Node.js, consulte o Guia de configuração do ambiente de desenvolvimento do Node.js.

npm install --save @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Para mais informações sobre a configuração do ambiente de desenvolvimento do Python, consulte o Guia de configuração do ambiente de desenvolvimento do Python.

pip install google-cloud-translate==2.0.1

Ruby

Para mais informações sobre a configuração do ambiente de desenvolvimento do Ruby, consulte o Guia de configuração do ambiente de desenvolvimento do Ruby.

gem install google-cloud-translate

Acesse Bibliotecas de cliente da Translation para instruções de instalação.

Limpar

Para evitar cobranças desnecessárias do Google Cloud, use o Console do Cloud para excluir o projeto se você não precisar dele.

A seguir