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 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.
Antes de começar
O 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.
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 Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
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.
Como ativar 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.
Definir cotas de uso
O 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 no 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, o Google Cloud exige que o principal tenha as permissões apropriadas. Você pode conceder permissões concedendo papéis a um principal. Para mais informações, consulte Controlar o acesso com o IAM.
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. Se uma biblioteca 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.
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 cloud.google.com/go/translate
Java
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.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
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-v2
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 cloud.google.com/go/translate/apiv3
Java
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.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
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
Instalar a CLI do Google Cloud
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 CLI gcloud, que está incluída na Google Cloud CLI. O link a seguir fornece mais informações:
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
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
Veja os guias de início rápido para fazer chamadas de tradução simples:
Consulte os guias de instruções para mais informações sobre como usar vários recursos do 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 também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
Faça um teste gratuito do Cloud Translation