Antes de começar

Para usar a API Cloud Vision, você precisa ativá-la para seu projeto:

1. Instale a Google Cloud CLI.

2. Configure a CLI gcloud para usar sua identidade federada.

   Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.

3. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

4. Crie ou selecione um Google Cloud projeto.

   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, você precisa do papel Criador de projetos (roles/resourcemanager.projectCreator), que contém a resourcemanager.projects.create permissão. Saiba como conceder papéis.
   Observação: se você não planeja manter os recursos criados neste procedimento, crie um projeto em vez de selecionar um já existente. Depois de concluir essas etapas, você pode excluir o projeto, removendo todos os recursos associados a ele.

   • Crie um Google Cloud projeto:

     gcloud projects create PROJECT_ID

     Substitua PROJECT_ID por um nome para o Google Cloud projeto que você está criando.

   • Selecione o Google Cloud projeto que você criou:

     gcloud config set project PROJECT_ID

     Substitua PROJECT_ID pelo nome do Google Cloud projeto.

5. Verifique se o faturamento está ativado para o Google Cloud projeto.

6. Ative a API Cloud Vision:

   Funções necessárias para ativar APIs

   Para ativar as APIs, é necessário ter a permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel Proprietário (roles/owner). Caso contrário, você pode receber essa permissão pelo papel Administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

   gcloud services enable vision.googleapis.com

7. Crie credenciais de autenticação local para sua conta de usuário:

   gcloud auth application-default login

   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.

8. Conceda papéis à sua conta de usuário. Execute uma vez o seguinte comando para cada um dos seguintes papéis do IAM: roles/storage.objectViewer

   gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • USER_IDENTIFIER: o identificador da sua conta de usuário. conta. Para exemplos, consulte Representar usuários do pool de força de trabalho nas políticas do IAM.
   • ROLE: o papel do IAM que você concede à sua conta de usuário.