Guia de início rápido: configurar a API Natural Language

Neste guia, você verá todas as etapas de configuração necessárias para começar a usar a Natural Language.

Sobre o Console do Google Cloud

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

Criar um projeto

Para usar os serviços fornecidos pelo Google Cloud, crie um projeto.

Um projeto organiza todos os seus recursos do Google Cloud. Um projeto consiste nos seguintes componentes:

  • um conjunto de colaboradores
  • APIs ativadas (e outros recursos)
  • ferramentas de monitoramento
  • informações de faturamento
  • 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.

No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

Acessar o seletor de projetos

Ativar 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 de faturamento.

Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

Ativar a API

Ative a API Cloud Natural Language para seu projeto. Para mais informações sobre como ativar APIs, consulte a documentação do Service Usage.

Ative a Cloud Natural Language API.

Ative a API

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á importantes conceitos de autenticação e etapas para a configuração. Para mais informações, consulte a Visão geral da autenticação do Google Cloud.

Sobre contas de serviço

Há várias opções de autenticação, mas é recomendável usar contas de serviço para autenticação e controle de acesso. Uma conta de serviço fornece credenciais para aplicativos, e não para 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.

Sobre os papéis

Nenhum papel é necessário para acessar a API Cloud Natural Language. Usuários ou aplicativos autenticados podem fazer chamadas para a API, independentemente das permissões.

Sobre as 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. Sua chave privada é 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

Crie uma conta de serviço:

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

    Acesse "Criar conta de serviço"
  2. Selecione o projeto.
  3. No campo Nome da conta de serviço, insira um nome. O Console do Google 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 em Concluído para terminar a criação da conta de serviço.

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

Crie uma chave de conta de serviço:

  1. No console do Google 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.

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. 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 suas credenciais.

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 suas credenciais.

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 suas credenciais.

Instale e inicialize a CLI gcloud

Se você planeja usar a API Natural Language, instale e inicialize a gcloud CLI. A gcloud CLI é um conjunto de ferramentas usadas para gerenciar recursos e aplicativos hospedados no Google Cloud, incluindo a gcloud CLI. O link a seguir fornece as instruções:

Instale a Google Cloud CLI e inicialize-a executando o seguinte comando:

gcloud init

Testar o SDK e a autenticação

Se você tiver configurado a autenticação nas etapas anteriores, poderá usar a gcloud CLI para testar o ambiente de autenticação. Execute o seguinte comando, 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 de REST da linha de comando da Natural Language para autenticar chamadas de API.

Instalar a biblioteca de cliente da API Natural Language

Você tem três opções para chamar a API Natural Language:

As bibliotecas de cliente estão disponíveis para vários idiomas conhecidos. Para informações sobre como instalar as bibliotecas de cliente, consulte Bibliotecas de cliente da Cloud Natural Language.