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 Google Cloud console do

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

Criar um projeto

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

Um projeto organiza todos os seus Google Cloud recursos do. 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 seus Google Cloud recursos em uma hierarquia de recursos. Para mais informações sobre projetos, consulte a documentação do Resource Manager.

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

Funções necessárias para selecionar ou criar um projeto

  • Selecionar um projeto: a seleção de um projeto não exige um papel específico do IAM. Você pode selecionar qualquer projeto em que tenha recebido um papel.
  • Criar um projeto: para criar um projeto, é necessário ter o papel de criador de projetos (roles/resourcemanager.projectCreator), que contém a resourcemanager.projects.create permissão. Saiba como conceder papéis.

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 o faturamento está ativado para o Google Cloud 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 API Cloud Natural Language.

Funções necessárias para ativar APIs

Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

Ativar a API

Instale e inicialize a CLI gcloud

Se você planeja usar a API Natural Language, você precisa instalar e inicializar a CLI gcloud. A CLI gcloud é um conjunto de ferramentas que você pode usar para gerenciar recursos e aplicativos hospedados no Google Cloud. Isso inclui a CLI gcloud. O link a seguir fornece as instruções:

Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

gcloud init

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

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.

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

gcloud

Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

gcloud init

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Bibliotecas de cliente

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

  1. Instale a Google Cloud CLI.

  2. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  3. Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário: 

    gcloud auth application-default login

    Não é necessário fazer isso se você estiver usando o Cloud Shell.

    Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Saiba mais em Configurar o ADC 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 que você vai informar à CLI gcloud.

    Instale a Google Cloud CLI.

    Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

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

Papéis IAM

Para receber as permissões necessárias para acessar a API Cloud Natural Language, peça ao administrador para conceder a você o papel do IAM de Consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer) no seu projeto de cota. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.