Esta página foi traduzida pela API Cloud Translation.
Switch to English

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.

Crie 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 a página do 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 o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

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

Quando uma identidade chama uma API, o Google Cloud exige que a identidade tenha as permissões apropriadas. Atribua papéis a uma conta de serviço para conceder permissões. Para mais informações, consulte a documentação do Gerenciamento de identidade e acesso.

Para testar a API Natural Language, use o papel Projeto > Proprietário nas etapas abaixo, que concede permissão total à conta de serviço para recursos no seu projeto. Se a conta de serviço não exigir permissões completas, especifique um papel mais restritivo usando o Console do Google Cloud. Para uma lista de papéis e permissões, consulte Referência de permissões do IAM. Para ver informações sobre o gerenciamento de permissões usando papéis do IAM, consulte Como atribuir papéis a contas de serviço.

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

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.

  5. Clique em Criar. O download de um arquivo JSON que contém sua chave é feito no seu 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]

Instale e inicialize o SDK do Cloud

Para usar a API Natural Language, instale e inicialize 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 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.