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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

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.

Make sure that billing is enabled for your Google Cloud project.

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.

Enable the Cloud Natural Language API.

Enable the API

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:

Install the Google Cloud CLI, then initialize it by running the following command: 

gcloud init

Configurar a autenticação

Qualquer aplicativo cliente que usa a API precisa ser autenticado e receber acesso aos recursos solicitados. A configuração da autenticação depende se você está trabalhando em um ambiente de desenvolvimento local ou configurando um ambiente de produção. Para mais informações, consulte Configurar o Application Default Credentials.

Select the tabs for how you plan to access the API:

gcloud

Install the Google Cloud CLI, then initialize it by running the following command: 

gcloud init

Bibliotecas de cliente

Para usar bibliotecas de cliente em um ambiente de desenvolvimento local, instale e inicialize o gcloud CLI e configure o Application Default Credentials com suas credenciais de usuário.

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

  3. If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local na documentação de autenticação do Google Cloud.

REST

Para usar a API REST em um ambiente de desenvolvimento local, use as credenciais fornecidas para a gcloud CLI.

    Install the Google Cloud CLI, then initialize it by running the following command: 

    gcloud init

Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Para informações sobre como configurar a autenticação para um ambiente de produção, consulte Set up Application Default Credentials for code running on Google Cloud na documentação de autenticação do Google Cloud.

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.

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.