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

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 forma de configurar a autenticação depende do ambiente de desenvolvimento local ou da configuração de um ambiente de produção. Para mais informações, consulte Configurar o Application Default Credentials.

Selecione as guias para definir como você quer acessar a API:

gcloud

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

gcloud init

C#

Para usar as amostras de .NET nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. Create local authentication credentials for your user account:

    gcloud auth application-default login

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

Go

Para usar as amostras de Go nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. Create local authentication credentials for your user account:

    gcloud auth application-default login

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

Java

Para usar as amostras de Java nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. Create local authentication credentials for your user account:

    gcloud auth application-default login

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

Node.js

Para usar as amostras de Node.js nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. Create local authentication credentials for your user account:

    gcloud auth application-default login

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

PHP

Para usar as amostras de PHP nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. Create local authentication credentials for your user account:

    gcloud auth application-default login

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

Python

Para usar as amostras de Python nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. Create local authentication credentials for your user account:

    gcloud auth application-default login

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

Ruby

Para usar as amostras de Ruby nesta página de um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e, em seguida, configure o Application Default Credentials com as credenciais de usuário.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. Create local authentication credentials for your user account:

    gcloud auth application-default login

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 as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

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

    gcloud init

Para informações sobre como configurar a autenticação para um ambiente de produção, consulte Configure o Application Default Credentials para o código em execução no 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.