Bibliotecas de cliente do AutoML Translation

Nesta página, você verá como dar os primeiros passos com as bibliotecas de cliente do Cloud para a API do AutoML. Aqui, você lê mais sobre as bibliotecas de cliente das APIs do Cloud, incluindo as bibliotecas de cliente das API do Google mais antigas.

Instalar a biblioteca de cliente

C#

Para mais informações, consulte Como configurar um ambiente de desenvolvimento em C#.

As bibliotecas de cliente em C# para o AutoML Translation estão sendo lançadas na versão Alfa.

install-package Google.Cloud.AutoML.V1 -pre

Go

Para mais informações, consulte Como configurar um ambiente de desenvolvimento do Go.

go get cloud.google.com/go/automl

Java

Para mais informações, consulte Como configurar um ambiente de desenvolvimento em 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>24.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-automl</artifactId>
  </dependency>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-bigquery</artifactId>
  </dependency>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-storage</artifactId>
  </dependency>
</dependencies>

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

implementation platform('com.google.cloud:libraries-bom:24.0.0')

implementation 'com.google.cloud:google-cloud-automl'

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

libraryDependencies += "com.google.cloud" % "google-cloud-automl" % "2.1.8"

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

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

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, consulte Como configurar um ambiente de desenvolvimento em Node.js.

npm install --save @google-cloud/automl

PHP

Para mais informações, consulte Como usar o PHP no Google Cloud.

composer require google/cloud-automl

Python

Para mais informações, consulte Como configurar um ambiente de desenvolvimento em Python.

pip install --upgrade google-cloud-automl

Ruby

Para mais informações, consulte Como configurar um ambiente de desenvolvimento em Ruby.

gem install google-cloud-automl

Como configurar a autenticação

Para executar a biblioteca de cliente, primeiro você precisa configurar a autenticação. Uma maneira de fazer isso é criar uma conta de serviço e definir uma variável de ambiente, conforme mostrado nas etapas a seguir. Para outras formas de autenticação, consulte Como autenticar como uma conta de serviço.

Console do Cloud

Crie uma conta de serviço:

1. No Console do Cloud, acesse a página Criar conta de serviço.

   Acesse Criar conta de serviço
2. Selecione um projeto.

3. No campo Nome da conta de serviço, insira um nome. O Console do Cloud preenche o campo ID da conta de serviço com base nesse nome.

   No campo Descrição da conta de serviço, insira uma descrição. Por exemplo, Service account for quickstart.

4. Clique em Criar e continuar.

5. Clique no campo Selecionar um papel.

   Em Acesso rápido, clique em Básico e em Proprietário.

   Observação: o campo Papel afeta quais recursos a conta de serviço pode acessar no projeto. É possível revogar esses papéis ou conceder outros papéis posteriormente. Em ambientes de produção, não conceda os papéis de proprietário, editor ou visualizador. Em vez disso, conceda um papel predefinido ou um papel personalizado que atenda às suas necessidades.
6. Clique em Continuar.

7. Clique em Concluído para terminar a criação da conta de serviço.

   Não feche a janela do navegador. Você vai usá-lo na próxima etapa.

Crie uma chave de conta de serviço:

1. No Console do Cloud, clique no endereço de e-mail da conta de serviço que você criou.
2. Clique em Chaves.
3. Clique em Adicionar chave e em Criar nova chave.
4. Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
5. Clique em Fechar.

Linha de comando

É possível executar os seguintes comandos usando o SDK do Cloud na máquina local ou no Cloud Shell.

1. Crie a conta de serviço. Substitua NAME por um nome para a conta de serviço.

   gcloud iam service-accounts create NAME

2. Conceda permissões à conta de serviço. Substitua PROJECT_ID pelo ID do seu projeto.

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:NAME@PROJECT_ID.iam.gserviceaccount.com" --role="roles/owner"

   Observação: a sinalização --role afeta quais recursos sua conta de serviço pode acessar no projeto. É possível revogar esses papéis ou conceder outros papéis posteriormente. Em ambientes de produção, não conceda os papéis de proprietário, editor ou visualizador. Em vez disso, conceda um papel predefinido ou um papel personalizado que atenda às suas necessidades.

3. Gere o arquivo de chave. Substitua FILE_NAME pelo nome do arquivo de chave.

   gcloud iam service-accounts keys create FILE_NAME.json --iam-account=NAME@PROJECT_ID.iam.gserviceaccount.com

Forneça credenciais de autenticação ao código do aplicativo definindo a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Essa variável se aplica somente à sessão de shell atual. Se você quiser que a variável seja aplicada em sessões de shell futuras, defina a variável no arquivo de inicialização de shell, por exemplo, no arquivo ~/.bashrc ou ~/.profile.

Linux ou macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

Exemplo:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

Para PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

Exemplo:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

Para prompt de comando:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

Substitua KEY_PATH pelo caminho do arquivo JSON que contém a chave da conta de serviço.

Usar a biblioteca de cliente

O exemplo a seguir mostra como usar a biblioteca de cliente.

C#

Para mais informações sobre como usar as bibliotecas de cliente com o AutoML Translation, consulte os seguintes guias:

• Como gerenciar conjuntos de dados
• Como gerenciar modelos
• Como avaliar modelos
• Como traduzir conteúdo

Go

Para mais informações sobre como usar as bibliotecas de cliente com o AutoML Translation, consulte os seguintes guias:

• Como gerenciar conjuntos de dados
• Como gerenciar modelos
• Como avaliar modelos
• Como traduzir conteúdo

Java

Para mais informações sobre como usar as bibliotecas de cliente com o AutoML Translation, consulte os seguintes guias:

• Como gerenciar conjuntos de dados
• Como gerenciar modelos
• Como avaliar modelos
• Como traduzir conteúdo

Node.js

Para mais informações sobre como usar as bibliotecas de cliente com o AutoML Translation, consulte os seguintes guias:

• Como gerenciar conjuntos de dados
• Como gerenciar modelos
• Como avaliar modelos
• Como traduzir conteúdo

PHP

Para mais informações sobre como usar as bibliotecas de cliente com o AutoML Translation, consulte os seguintes guias:

• Como gerenciar conjuntos de dados
• Como gerenciar modelos
• Como avaliar modelos
• Como traduzir conteúdo

Python

Para mais informações sobre como usar as bibliotecas de cliente com o AutoML Translation, consulte os seguintes guias:

• Como gerenciar conjuntos de dados
• Como gerenciar modelos
• Como avaliar modelos
• Como traduzir conteúdo

Ruby

Para mais informações sobre como usar as bibliotecas de cliente com o AutoML Translation, consulte os seguintes guias:

• Como gerenciar conjuntos de dados
• Como gerenciar modelos
• Como avaliar modelos
• Como traduzir conteúdo

Outros recursos

C#

• Documentos de referência de APIs
• Código-fonte (em inglês)
• Controle de problemas do GitHub (em inglês)
• Stack Overflow (em inglês)

Go

• Documentos de referência de APIs
• Código-fonte (em inglês)
• Controle de problemas do GitHub (em inglês)
• Stack Overflow

Java

• Documentos de referência de APIs
• Código-fonte (em inglês)
• Controle de problemas do GitHub (em inglês)
• Stack Overflow (em inglês)

Node.js

• Documentos de referência de APIs
• Código-fonte (em inglês)
• Controle de problemas do GitHub (em inglês)
• Stack Overflow (em inglês)

PHP

• Documentos de referência de APIs
• Código-fonte (em inglês)
• Controle de problemas do GitHub (em inglês)
• Stack Overflow (em inglês)

Python

• Documentos de referência de APIs
• Código-fonte (em inglês)
• Controle de problemas do GitHub (em inglês)
• Stack Overflow (em inglês)

Ruby

• Documentos de referência de APIs
• Código-fonte (em inglês)
• Controle de problemas do GitHub (em inglês)
• Stack Overflow