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

A Tradução Cloud está disponível em duas edições (Básica e Avançada). 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 role (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.

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.

Instalar bibliotecas cliente

As bibliotecas cliente estão disponíveis para vários idiomas populares. Recomendamos que use estas bibliotecas cliente para fazer chamadas ao 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 de 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

Ir

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.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <