Configuração

Para começar a usar a 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 processo de configuração envolve o uso do 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.

Antes de começar

A Cloud Translation está disponível em duas edições: Basic e Advanced. Decida qual edição usar porque cada edição tem seu próprio conjunto de bibliotecas de cliente.

Criar ou selecionar um projeto

Para usar os serviços fornecidos pelo Google Cloud, crie um projeto. Um projeto organiza todos os seus recursos do Google Cloud . O projeto 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 seus 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 Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .

Funções necessárias para selecionar ou criar um projeto

• Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
• Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

Acessar o seletor de projetos

Ativar faturamento

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

Observação: para ajudar você a gerenciar o orçamento, defina limites de uso nos projetos. Para mais informações, consulte Definir cotas de uso.

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 o faturamento está ativado para o projeto do Google Cloud .

Ativar a API

É necessário ativar a API Cloud Translation para seu projeto. Para mais informações sobre como ativar APIs, consulte a documentação do Service Usage.

Ative a API Cloud Translation.

Funções necessárias para ativar APIs

Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

Ativar a API

Definir cotas de uso

A Cloud Translation tem um sistema de gerenciamento de cotas para ajudar você e o Google a gerenciar o uso do serviço. Por padrão, o número de caracteres que é possível enviar por dia é ilimitado. Se você tiver um orçamento definido, recomendamos monitorar o uso diário e ajustar as cotas de acordo com o gasto planejado.

Para mais informações sobre cotas, consulte Cotas e limites.

Configurar a autenticação

Se você planeja usar a API Cloud Translation, é necessário configurar a autenticação. Qualquer aplicativo cliente que usa a API precisa ser autenticado e receber acesso aos recursos solicitados. Para mais informações, consulte Autenticar na Cloud Translation.

Papéis do Identity and Access Management

Quando um principal (conta de usuário, conta de serviço e assim por diante) chama uma API, oGoogle Cloud exige que o principal tenha as permissões apropriadas. Conceda permissões atribuindo papéis a um principal. Para mais informações, consulte Controlar o acesso com o IAM.

Observação: as permissões de papel se aplicam apenas à Cloud Translation – Advanced. Embora você possa usar contas de serviço para ambas as edições, só é possível definir permissões específicas para a Cloud Translation – Advanced. Para a Cloud Translation – Basic, é possível fazer qualquer solicitação independentemente das permissões da conta de serviço.

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 a Cloud Translation porque elas facilitam o acesso às APIs. Se uma biblioteca de cliente não atender às suas necessidades ou não estiver disponível para sua linguagem, crie seu próprio código personalizado. Para mais informações, consulte Usar seu próprio código de cliente.

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.

Cloud Translation – Basic: bibliotecas de cliente

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 da Cloud Translation – Basic.

C#

nuget install Google.Cloud.Translation.V2

Go

go get cloud.google.com/go/translate

Java

Cuidado:a biblioteca de cliente do Java não é compatível com Android.

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>26.78.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:

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

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

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

Se você estiver usando o Visual Studio Code ou o IntelliJ, poderá adicionar bibliotecas de cliente ao projeto usando estes plug-ins de IDE:

• Cloud Code para VS Code
• Cloud Code para IntelliJ

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.

Observação: as bibliotecas de cliente Java para Google Cloud atualmente não são compatíveis com Android.

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 @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 de desenvolvimento do Ruby para mais informações sobre esse assunto.

gem install google-cloud-translate-v2

Cloud Translation – Advanced: bibliotecas de cliente

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 da Cloud Translation – Advanced.

C#

nuget install Google.Cloud.Translate.V3 -Pre

Go

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

Java

Cuidado:a biblioteca de cliente do Java não é compatível com Android.

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>26.78.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:

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

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

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

Se você estiver usando o Visual Studio Code ou o IntelliJ, poderá adicionar bibliotecas de cliente ao projeto usando estes plug-ins de IDE:

• Cloud Code para VS Code
• Cloud Code para IntelliJ

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.

Observação: as bibliotecas de cliente Java para Google Cloud atualmente não são compatíveis com Android.

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 @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 de desenvolvimento do Ruby para mais informações sobre esse assunto.

gem install google-cloud-translate

Como instalar a CLI do Google Cloud

Observação: ignore esta etapa se não estiver usando a linha de comando para fazer chamadas de API autenticadas.

Se você planeja enviar solicitações da Cloud Translation usando a linha de comando, por exemplo, usando comandos curl, instale e inicialize a gcloud CLI, que está incluída na CLI do Google Cloud. O seguinte link fornece mais informações:

Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:

gcloud init

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

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 seguinte comando 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 da Cloud Translation para autenticar chamadas de API.

A seguir

• Use os guias de início rápido para fazer chamadas de tradução simples:

  • Guia de início rápido da Cloud Translation – Basic
  • Guia de início rápido da Cloud Translation – Advanced

• Consulte a visão geral do produto para mais informações sobre como usar vários recursos da Cloud Translation.

Faça um teste

Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud Translation em situações reais. Clientes novos recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Faça um teste sem custo financeiro da Cloud Translation