Configuração

Para começar a usar o Cloud Translation, você precisa de um projeto que tenha a API Cloud Translation ativada e credenciais para fazer chamadas autenticadas. Nas seções a seguir, detalhamos como configurar antes de fazer sua primeira chamada para a API Cloud Translation.

O Cloud Translation está disponível em duas edições. Antes de começar, decida qual edição será usada porque as instalações da biblioteca de cliente são diferentes.

O processo de configuração envolve o Console do Google Cloud, que é uma interface da Web que pode ser usada para provisionar, configurar, gerenciar e monitorar sistemas no Google Cloud. Se você nunca usou o Console do Google Cloud, consulte a página Console do Cloud para mais informações.

Crie ou selecione um projeto.

Para usar os serviços fornecidos pelo Google Cloud, crie um projeto. Um projeto organiza todos os seus recursos do Google Cloud. Ele consiste em um conjunto de colaboradores, APIs ativadas (e outros recursos), ferramentas de monitoramento, informações de faturamento e controles de autenticação e acesso. Crie um ou vários projetos e use-os para organizar os recursos do Google Cloud em uma hierarquia de recursos. Ao criar um projeto, anote o ID do projeto. Você precisará desse ID para fazer chamadas de API. Para mais informações sobre projetos, consulte a documentação do Resource Manager.

Recomendamos que você crie projetos separados para experimentos, testes e produção. Depois de criar um projeto, registre o número ou o ID dele. Forneça o número ou ID do projeto ao fazer chamadas para a API Cloud Translation.

No Console do Cloud, na página do seletor de projetos, selecione ou crie um projeto do Cloud.

Acessar a página do seletor de projetos

Ativar faturamento

Ative o faturamento para usar o Cloud Translation. Para mais informações sobre os preços do Cloud Translation, consulte a página de preços.

Uma conta de faturamento é usada para definir quem paga por determinado conjunto de recursos e pode estar associada a um ou mais projetos. O uso do projeto é cobrado na conta de faturamento vinculada. Na maioria dos casos, você configura o faturamento ao criar um projeto. Para mais informações, consulte a Documentação de faturamento.

Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu projeto.

Ative a API

Ative a API Cloud Translation no seu projeto. Para mais informações sobre como ativar APIs, consulte a documentação do Service Usage.

Ative a Cloud Translation API.

Ative a API

Configurar a autenticação

Se você planeja usar a API Cloud Translation, é necessário configurar a autenticação. Qualquer aplicativo cliente que use a API precisa ser autenticado e ter acesso aos recursos solicitados. Nesta seção, você verá importantes conceitos de autenticação e etapas para a configuração deles. Para mais informações, consulte a Visão geral da autenticação do Google Cloud.

Conta de serviço e chave privada

Há várias opções de autenticação, mas é recomendável usar contas de serviço para autenticação e controle de acesso. Uma conta de serviço fornece credenciais de aplicativos e não de usuários finais. As contas de serviço são de propriedade dos projetos, e você pode criar muitas para um projeto. Para mais informações, consulte as Noções básicas sobre contas de serviço.

As contas de serviço estão associadas a um ou mais pares de chaves públicas/privadas. Ao criar um novo par de chaves, você faz o download da chave privada. Ela é usada para gerar credenciais ao chamar a API. Você é responsável pela segurança da chave privada e outras operações de gerenciamento, como a rotação de chaves.

Papéis do Identity and Access Management

Quando uma identidade chama uma API, o Google Cloud exige que a identidade tenha as permissões apropriadas. Atribua papéis a uma conta de serviço para conceder permissões. Para mais informações, consulte a documentação do Gerenciamento de identidade e acesso (IAM, na sigla em inglês).

Como criar contas de serviço e chaves

Configurar a autenticação:

  1. No Console do Cloud, acesse a página Criar chave da conta de serviço.

    Acessar página "Criar chave da conta de serviço"
  2. Na lista Conta de serviço, selecione Nova conta de serviço.
  3. No campo Nome da conta de serviço, insira um nome.
  4. Na lista Papel, selecione Projeto > Proprietário.

    Observação: o campo Papel autoriza sua conta de serviço a acessar recursos. É possível visualizar e alterar esse campo mais tarde usando o Console do Cloud. Se você estiver desenvolvendo um aplicativo de produção, especifique permissões mais granulares do que Projeto > Proprietário. Para mais informações, consulte Como atribuir papéis a contas de serviço.
  5. Clique em Criar. O download de um arquivo JSON que contém a chave é feito no computador.

Para mais informações sobre os diferentes papéis, consulte Papéis avançados do Cloud Translation. Por exemplo, se você quiser que sua conta de serviço traduza texto, atribua o papel roles/cloudtranslate.user a ela. Todas as chaves associadas a essa conta de serviço recebem as mesmas permissões.

Como usar o arquivo de chave da conta de serviço no seu ambiente

Forneça credenciais de autenticação ao código do aplicativo definindo a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Substitua [PATH] pelo caminho do arquivo JSON que contém sua chave da conta de serviço. Essa variável só se aplica à sessão de shell atual. Assim, se você abrir uma nova sessão, precisará definir a variável novamente.

Linux ou macOS

export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Exemplo:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"

Windows

Com o PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Exemplo:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"

Com prompt de comando:

set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

Como instalar bibliotecas de cliente

Bibliotecas de clientes estão disponíveis para várias linguagens conhecidas. Recomendamos que você use essas bibliotecas de cliente para fazer chamadas para o Cloud Translation porque elas facilitam o acesso às APIs.

Por exemplo, quando você usa uma biblioteca de cliente, ela pode determinar suas credenciais de maneira implícita por meio da variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Você não precisa especificar explicitamente suas credenciais no código. Para mais informações, consulte Explicações sobre bibliotecas de cliente na documentação das APIs do Cloud.

Bibliotecas de cliente do Cloud Translation - Basic

Selecione a linguagem de programação que você está usando para desenvolvimento e execute o comando relacionado. Para mais informações, consulte a visão geral das bibliotecas de cliente do Cloud Translation - Basic.

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>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>

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

Consulte o Guia de configuração do ambiente para desenvolvedores do Ruby para mais informações sobre esse assunto.

gem install google-cloud-translate

Bibliotecas de cliente do Cloud Translation - Advanced

Selecione a linguagem de programação que você está usando para desenvolvimento e execute o comando relacionado. Para mais informações, consulte a visão geral das bibliotecas de cliente do Cloud Translation . Advanced.

C#

nuget install Google.Cloud.Translate.V3 -Pre

Go

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

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>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>

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 --upgrade google-cloud-translate

Ruby

Consulte o Guia de configuração do ambiente para desenvolvedores do Ruby para mais informações sobre esse assunto.

gem install google-cloud-translate

Instale o Cloud SDK

Se você planeja enviar solicitações da Cloud Translation por meio da linha de comando, como por meio de comandos curl, instale e inicialize a ferramenta de linha de comando gcloud, que está incluída no SDK do Cloud. O link a seguir fornece mais informações:

Instale e inicialize o SDK do Cloud..

Testar o SDK e a autenticação

Se você tiver configurado a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS, poderá usar gcloud para testar seu ambiente de autenticação. Execute o comando a seguir e verifique se nenhum erro ocorre e se as credenciais são retornadas:

gcloud auth application-default print-access-token

O comando anterior é usado por todas as amostras de REST da linha de comando do Cloud Translation para autenticar chamadas de API.

A seguir