Configuração e limpeza do Cloud Vision

Este guia fornece todos os passos de configuração necessários para começar a usar o Cloud Vision. Também fornece sugestões para possíveis passos de limpeza após experimentar ou testar o Cloud Vision.

Acerca da Google Cloud consola

A Google Cloud consola (visite a documentação, abra a consola) é uma IU da Web usada para aprovisionar, configurar, gerir e monitorizar sistemas que usam Google Cloud produtos. Usa a Google Cloud consola para configurar e gerir recursos do Vision.

Criar um projeto

Para usar os serviços fornecidos por Google Cloud, tem de criar um projeto. Um projeto organiza todos os seus Google Cloud recursos. Um projeto consiste num conjunto de colaboradores, APIs ativadas (e outros recursos), ferramentas de monitorização, informações de faturação, e controlos de autenticação e acesso. Pode criar um projeto ou criar vários projetos e usá-los para organizar os seus Google Cloud recursos numa hierarquia de recursos. Quando criar um projeto, tome nota do ID do projeto. Precisa deste ID para fazer chamadas API. 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 faturação

Uma conta de faturação é usada para definir quem paga por um determinado conjunto de recursos e pode ser associada a um ou mais projetos. A utilização do projeto é cobrada à conta de faturação associada. Na maioria dos casos, configura a faturação quando cria um projeto. Para mais informações, consulte a documentação de faturação.

Verify that billing is enabled for your Google Cloud project.

Ative a API

Tem de ativar a API Vision para o seu projeto. Para mais informações sobre a ativação de APIs, consulte a documentação de utilização de serviços.

Enable the Vision API.

Enable the API

Instale e inicialize a CLI Google Cloud

Se planeia usar a API Vision, tem de instalar e inicializar a CLI Google Cloud. A CLI gcloud é um conjunto de ferramentas que pode usar para gerir recursos e aplicações alojados no Google Cloud.

O seguinte link fornece instruções:

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

gcloud init

Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Configure a autenticação e o controlo de acesso

Se planeia usar a API Vision, tem de configurar a autenticação. Qualquer aplicação cliente que use a API tem de ser autenticada e ter acesso concedido aos recursos pedidos. Esta secção descreve conceitos de autenticação importantes e fornece passos para a configuração. Para mais informações, consulte a Google Cloud vista geral da autenticação.

Autenticação com contas de utilizador

As contas de utilizador são a melhor opção de autenticação quando está a aprender a usar a API Vision e para o desenvolvimento local. Pode usar a sua conta de utilizador para autenticar execuções de linha de comandos REST ou chamadas de biblioteca de cliente.

Autenticação de conta de utilizador da linha de comandos REST

Para autenticar chamadas de linha de comandos REST, use a CLI gcloud. O comando gcloud auth login inicia sessão no gcloud com a sua conta de utilizador, o que deve ser feito antes de chamar a API. O comando gcloud auth print-access-token é usado em todos os exemplos de linhas de comando REST nesta documentação para autenticar chamadas REST.

Para criar credenciais de utilizador para o seu ambiente local: 

gcloud auth login

Autenticação da conta de utilizador da biblioteca cliente

Para fazer a autenticação para chamadas de bibliotecas cliente, usa a CLI gcloud. O comando gcloud auth application-default login inicia sessão no gcloud para as credenciais predefinidas da aplicação com a sua conta de utilizador, o que deve ser feito antes de chamar a API. O comando gcloud auth application-default set-quota-project tem de ser usado para definir o seu projeto para faturação e quotas relacionadas com chamadas API. Normalmente, este é o mesmo projeto usado pelo seu agente e fornece o ID do projeto que criou nos passos acima.

A variável de ambiente GOOGLE_APPLICATION_CREDENTIALS não deve ser definida para que as credenciais predefinidas da aplicação sejam usadas pelas bibliotecas de cliente.

Para criar credenciais predefinidas da aplicação para o seu ambiente local: 

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Autenticação com contas de serviço

As contas de serviço fornecem credenciais para aplicações, em vez de utilizadores finais. As contas de serviço são propriedade dos projetos e pode criar muitas contas de serviço para um projeto. Para mais informações, consulte:

Controlo de acesso com funções

Quando um principal (conta de utilizador, conta de serviço, etc.) chama uma API, Google Cloud requer que o principal tenha as autorizações adequadas. Pode conceder autorizações atribuindo funções a um principal. Para mais informações, consulte a vista geral das funções.

Se criou o seu projeto com a sua conta de utilizador, a sua conta de utilizador tem a função básica de proprietário para o projeto. Esta função fornece acesso para chamar qualquer API para o projeto. No entanto, se o projeto tiver sido criado por uma conta diferente, pode ter de ter funções concedidas à sua conta de utilizador antes de poder chamar a API.

Instale a biblioteca cliente da API Vision

Tem três opções para chamar a API Vision:

As bibliotecas cliente estão disponíveis para vários idiomas populares. Para obter informações sobre a instalação das bibliotecas cliente, consulte as bibliotecas cliente da API Vision.

Limpeza

Depois da configuração e de experimentar ou testar o Vision, pode querer eliminar os recursos que criou:

  • Pode querer encerrar o seu projeto.
  • Se chamou gcloud auth login, isto armazena as credenciais no diretório do utilizador no seu computador. Pode eliminar estas credenciais chamando: 
    gcloud auth revoke
  • Se chamou gcloud auth application-default login, isto armazena as credenciais no diretório do utilizador no seu computador. Pode eliminar estas credenciais chamando: 
    gcloud auth application-default revoke