Configuração

Para começar a usar o Cloud Translation, precisa de um projeto com a API Cloud Translation ativada e credenciais para fazer chamadas autenticadas. As secções seguintes detalham como fazer a configuração antes de fazer a primeira chamada à API Cloud Translation.

O processo de configuração envolve a Google Cloud consola, que é uma interface Web que pode usar para aprovisionar, configurar, gerir e monitorizar sistemas no Google Cloud. Se nunca usou a Google Cloud consola, consulte a página Consola do Google Cloud para mais informações.

Antes de começar

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

Crie ou selecione um projeto

Para usar os serviços fornecidos pela Google Cloud, tem de criar um projeto. Um projeto organiza todos os seus Google Cloud recursos. Um projeto consiste num conjunto de colaboradores, APIs ativadas (e outros recursos), ferramentas de monitorização, informações de faturação, e controlos de autenticação e acesso. Pode criar um projeto ou criar vários projetos e usá-los para organizar os seus Google Cloud recursos numa hierarquia de recursos. Quando criar um projeto, tome nota do ID do projeto. Precisa deste ID para fazer chamadas API. Para mais informações sobre projetos, consulte a documentação do Resource Manager.

Recomendamos que crie projetos separados para experiências, testes e produção. Depois de criar um projeto, registe o número do projeto ou o ID. Tem de indicar o número (ou o ID) do projeto quando faz chamadas para a API Cloud Translation.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Ativar faturação

Tem de ativar a faturação para usar o Cloud Translation. Para mais informações sobre os preços do Cloud Translation, consulte a página de preços.

Nota: para ajudar a gerir o seu orçamento, pode definir os limites de utilização nos seus projetos. Para mais informações, consulte o artigo Defina quotas de utilização.

Uma conta de faturação é usada para definir quem paga por um determinado conjunto de recursos e pode ser associada a um ou mais projetos. A utilização do projeto é cobrada à conta de faturação associada. Na maioria dos casos, configura a faturação quando cria um projeto. Para mais informações, consulte a documentação de faturação.

Verify that billing is enabled for your Google Cloud project.

Ativar a API

Tem de ativar a API Cloud Translation para o seu projeto. Para mais informações sobre a ativação de APIs, consulte a documentação de utilização de serviços.

Enable the Cloud Translation API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Defina quotas de utilização

O Cloud Translation tem um sistema de gestão de quotas para ajudar a si e à Google a gerir a utilização do serviço. Por predefinição, o número de carateres que pode enviar por dia é ilimitado. Se tiver um orçamento definido, recomendamos que monitorize a sua utilização diária e ajuste as quotas de acordo com os gastos planeados.

Para mais informações sobre quotas, consulte o artigo Quotas e limites.

Configure a autenticação

Se planeia usar a API Cloud Translation, tem de configurar a autenticação. Qualquer aplicação cliente que use a API tem de ser autenticada e receber acesso aos recursos pedidos. Para mais informações, consulte o artigo Autentique-se no Cloud Translation.

Funções de gestão de identidade e de acesso

Quando um principal (conta de utilizador, conta de serviço, etc.) chama uma API, Google Cloud requer que o principal tenha as autorizações adequadas. Pode conceder autorizações atribuindo funções a um principal. Para mais informações, consulte o artigo Controle o acesso com a IAM.

Nota: as autorizações de funções aplicam-se apenas ao Cloud Translation – Advanced. Embora possa usar contas de serviço para ambas as edições, só pode definir autorizações específicas para o Cloud Translation – Advanced. Para o Cloud Translation - Basic, pode fazer qualquer pedido, independentemente das autorizações da conta de serviço.

Instalar bibliotecas de cliente

As bibliotecas cliente estão disponíveis para vários idiomas populares. Recomendamos que use estas bibliotecas cliente para fazer chamadas para o Cloud Translation, porque facilitam o acesso às APIs. Se uma biblioteca cliente não satisfizer as suas necessidades ou não estiver disponível para o seu idioma, crie o seu próprio código personalizado. Para mais informações, consulte o artigo Usar o seu próprio código do cliente.

Por exemplo, quando usa uma biblioteca de cliente, esta pode determinar as suas credenciais implicitamente através da variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Não precisa de especificar explicitamente as suas credenciais no código. Para mais informações, consulte o artigo Bibliotecas de cliente explicadas na documentação das APIs Google Cloud.

Tradução Cloud – Bibliotecas de cliente básicas

Selecione a linguagem de programação que está a usar para o desenvolvimento e, de seguida, execute o comando relacionado. Para mais informações, consulte a vista 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

Aviso: a biblioteca cliente Java não suporta o Android.

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.

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

If you are using Gradle, add the following to your dependencies:

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

Node.js

Para mais informações sobre a configuração do seu ambiente de programação Node.js, consulte o guia de configuração do ambiente de programação Node.js.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Para mais informações sobre como configurar o seu ambiente de programação Python, consulte o guia de configuração do ambiente de programação Python.

pip install google-cloud-translate==2.0.1

Ruby

Para mais informações sobre como configurar o seu ambiente de programação Ruby, consulte o guia de configuração do ambiente de programação Ruby.

gem install google-cloud-translate-v2

Tradução Cloud – Bibliotecas de cliente avançadas

Selecione a linguagem de programação que está a usar para o desenvolvimento e, de seguida, execute o comando relacionado. Para mais informações, consulte a vista 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

Aviso: a biblioteca cliente Java não suporta o Android.

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.

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

If you are using Gradle, add the following to your dependencies:

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Note: Cloud Java client libraries do not currently support Android.

Node.js

Para mais informações sobre a configuração do seu ambiente de programação Node.js, consulte o guia de configuração do ambiente de programação Node.js.

npm install @google-cloud/translate

PHP

composer require google/cloud-translate

Python

Para mais informações sobre como configurar o seu ambiente de programação Python, consulte o guia de configuração do ambiente de programação Python.

pip install --upgrade google-cloud-translate

Ruby

Para mais informações sobre como configurar o seu ambiente de programação Ruby, consulte o guia de configuração do ambiente de programação Ruby.

gem install google-cloud-translate

Instale a CLI Google Cloud

Nota: pode ignorar este passo se não usar a linha de comandos para fazer chamadas de API autenticadas.

Se planeia enviar pedidos do Cloud Translation através da linha de comandos (como através de comandos curl), instale e inicialize a CLI gcloud , que está incluída na CLI Google Cloud. O link seguinte fornece mais informações:

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

gcloud init

Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Teste o SDK e a autenticação

Se configurou a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS, pode usar gcloud para testar o seu ambiente de autenticação. Execute o seguinte comando e verifique se não ocorre nenhum erro e se são devolvidas credenciais:

gcloud auth application-default print-access-token

O comando anterior é usado por todos os exemplos REST da linha de comandos do Cloud Translation para autenticar chamadas API.

O que se segue?

• Experimente os inícios rápidos para fazer chamadas de tradução simples:

  • Início rápido do Cloud Translation – Básico
  • Tradução Cloud – Início rápido avançado

• Consulte os guias de instruções para mais informações sobre a utilização de várias funcionalidades do Cloud Translation.

Experimente

Se está a usar o Google Cloud pela primeira vez, crie uma conta para avaliar o desempenho do Cloud Translation em cenários reais. Os novos clientes também recebem 300 USD em créditos gratuitos para executar, testar e implementar cargas de trabalho.

Experimente a Tradução Cloud gratuitamente