Guia de início rápido: configuração (Advanced)

Antes de começar

O Cloud Translation está disponível em duas edições. Neste guia, você vê todas as etapas de configuração necessárias para começar a usar o Cloud Translation – Advanced.

Google Cloud Console

O Console do Google Cloud é uma IU da Web usada para provisionar, configurar, gerenciar e monitorar sistemas que usam produtos do Google Cloud. Utilize o Console do Google Cloud para configurar e gerenciar recursos da Cloud Translation.

Criar um projeto

Para usar os serviços fornecidos pelo Google Cloud, crie um projeto. Ele organiza todos os 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 os recursos do Google Cloud em uma hierarquia de recursos. Para mais informações sobre projetos, consulte a documentação do Resource Manager.

Se você planeja usar o projeto para algo além do acesso básico ao Cloud Translation – Basic ou pretende utilizar a API, crie um projeto com o Console do Google Cloud, conforme descrito abaixo.

Você precisa criar projetos separados para experimentos, testes e produção. Ao criar um projeto, anote o número ou ID dele. Você precisa fornecê-los 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

Ativando faturamento

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 do faturamento.

  1. Acesse o Google Cloud Console.
  2. Navegue até o menu suspenso na parte superior da página e escolha o projeto do Google Cloud que você quer associar ao Cloud Translation.

    Se você já criou um ou mais projetos, eles são exibidos em uma lista no menu suspenso. Escolha um projeto existente (uma marca de seleção aparece ao lado do projeto selecionado) ou crie um novo projeto, clicando em Novo Projeto. Para mais detalhes sobre a criação de um projeto do Google Cloud, consulte Como criar e gerenciar projetos.

    Caixa de diálogo

  3. Selecione/confirme a conta de faturamento.

    • Se criar um novo projeto, você precisará vincular uma conta de faturamento a ele.
    • Se você estiver usando um projeto existente, verifique se o faturamento está ativado. É possível acessar as informações de faturamento do projeto a qualquer momento acessando o menu de navegação principal (), clicando em Faturamento.

Ative a API

Para ativar o Translation, use o Console do Google Cloud.

  1. Acesse o menu de navegação principal (menu) no Console do Google Cloud.

  2. Acesse a seção Inteligência artificial e clique em Translation.

  3. No card Modelos do Translation, clique em Ativar API. Se a API já estiver ativada, o Console do Cloud mostrará o Painel do Translation.

Como testar a API

Se você quiser testar a API sem vinculá-la ao projeto, escolha a opção Testar a API.

Configurar a autenticação

Depois de ativar a geração de registros de dados, você precisará vincular uma ou mais contas de serviço à API Cloud Translation. Se você planeja usar a Translation, é necessário configurar a autenticação. Qualquer aplicativo cliente que usa a API precisa ser autenticado e ter acesso aos recursos solicitados. Nesta seção, você verá conceitos de autenticação importantes e as etapas para configurar a autenticação. Para mais informações, consulte a Visão geral da autenticação do Google Cloud.

Contas de serviço

Uma conta de serviço fornece credenciais de aplicativos, e não de usuários finais. As contas de serviço pertencem aos projetos, e é possível criar muitas para um projeto. Para mais informações, consulte Contas de serviço.

Papéis

Quando a API é chamada, o Google Cloud exige que o autor da chamada tenha as permissões apropriadas. Atribua papéis a uma conta de serviço para conceder permissões. Por exemplo, se você quiser usar sua conta de serviço para traduzir texto, atribua o papel roles/cloudtranslate.user a ela. Para testar a API Cloud Translation, use o papel Projeto > Editor nas etapas abaixo. Ele concede à conta de serviço acesso total ao projeto. Consulte Permissões do Cloud IAM para detalhes completos sobre os papéis disponíveis e as permissões aceitas em cada um deles.

Para noções básicas sobre papéis, consulte a documentação do Cloud Identity and Access Management.

Chaves da conta 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.

Criar uma conta de serviço e fazer o download do arquivo de chave privada

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.

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]

Instalar e inicializar o SDK do Cloud

Se você planeja usar a Translation, é necessário instalar e inicializar o SDK do Cloud. Ele é um conjunto de ferramentas para gerenciar recursos e aplicativos hospedados no Google Cloud. Isso inclui a ferramenta de linha de comando gcloud. O link a seguir fornece as instruções:

Instale e inicialize o SDK do Cloud..

Testar o SDK e a autenticação

Se você tiver configurado a autenticação nas etapas anteriores, poderá usar a ferramenta gcloud para testar o 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

Esse comando é usado por todas as amostras REST da linha de comando do Cloud Translation – Advanced para autenticar chamadas de API.

Instalar a biblioteca de cliente do Cloud Translation – Advanced

As bibliotecas de cliente estão disponíveis para várias linguagens conhecidas. Estas são as opções recomendadas. Para instalar uma biblioteca de cliente:

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>8.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>

Se você estiver usando o Gradle, adicione isto às dependências:

compile 'com.google.cloud:google-cloud-translate:1.95.0'

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

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

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

Para mais informações sobre a configuração do ambiente de desenvolvimento do Ruby, consulte o Guia de configuração do ambiente de desenvolvimento do Ruby.

gem install google-cloud-translate

Acesse Bibliotecas de cliente da API Translation para instruções de instalação em cada linguagem compatível.

Limpar

Para evitar cobranças desnecessárias do Google Cloud, use o Console do Google Cloud para excluir o projeto se ele não for mais necessário.

A seguir