Configuración y limpieza de Cloud Vision

En esta guía, se proporcionan todos los pasos de configuración necesarios para comenzar a usar Cloud Vision. También se proporcionan consejos para posibles pasos de limpieza después de conocer o probar Cloud Vision.

Acerca de la consola de Google Cloud

La consola de Google Cloud (consultar la documentación, abrir la consola) es una IU web que se usa para aprovisionar, configurar, administrar y supervisar los sistemas que usan productos de Google Cloud. La consola de Google Cloud se puede usar para configurar y administrar los recursos de Vision.

Crea un proyecto

Para usar los servicios que proporciona Google Cloud, debes crear un proyecto. En él, se organizan todos tus recursos de Google Cloud. Un proyecto consta de un conjunto de colaboradores, API habilitadas (y otros recursos), herramientas de supervisión, datos de facturación y controles de autenticación y acceso. Puedes crear uno o varios proyectos y usarlos para organizar tus recursos de Google Cloud en una jerarquía de recursos. Cuando creas un proyecto, toma nota del ID del proyecto. Necesitarás este ID para realizar llamadas a la API. Para obtener más información sobre los proyectos, consulta la documentación del Administrador de recursos.

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

Go to project selector

Habilitar facturación

Se usa una cuenta de facturación para definir quién paga por un conjunto específico de recursos y puede vincularse a uno o más proyectos. El uso del proyecto se cobra a la cuenta de facturación vinculada. En la mayoría de los casos, configuras la facturación cuando creas un proyecto. Para obtener más información, consulta la documentación de la facturación.

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

Habilitar la API

Debes habilitar la API de Vision para tu proyecto. Para obtener más información sobre cómo habilitar las API, consulta la documentación de Service Usage.

Enable the Vision API.

Enable the API

Instala y, luego, inicializa el SDK de Google Cloud.

Si planeas usar la API de Vision, debes instalar e inicializar Google Cloud CLI. La CLI de gcloud es un conjunto de herramientas que puedes usar para administrar recursos y aplicaciones alojados en Google Cloud.

En el siguiente vínculo, se proporcionan instrucciones:

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

gcloud init

Configura la autenticación y el control de acceso

Si planeas usar la API de Dialogflow, debes configurar la autenticación. Cualquier aplicación cliente que use la API debe estar autenticada y tener acceso a los recursos solicitados. En esta sección, se describen conceptos importantes de autenticación y se proporcionan pasos para configurarla. Para obtener más información, consulta la Descripción general de la autenticación.

Autenticación con cuentas de usuario

Las cuentas de usuario son la mejor opción de autenticación cuando se aprende a usar la API de Vision y para el desarrollo local. Puedes usar tu cuenta de usuario para autenticar las ejecuciones de la línea de comandos de REST o las llamadas a la biblioteca cliente.

Autenticación de la cuenta de usuario de la línea de comandos de REST

Para autenticar las llamadas de línea de comandos de REST, usa la CLI de gcloud. El comando gcloud auth login te permite acceder a gcloud con tu cuenta de usuario, lo que se debe hacer antes de llamar a la API. El comando gcloud auth print-access-token se usa en las muestras de la línea de comandos de REST de esta documentación para autenticar las llamadas de REST.

Para crear credenciales de usuario en tu entorno local, sigue estos pasos: 

gcloud auth login

Autenticación de la cuenta de usuario de la biblioteca cliente

Para autenticar las llamadas de la biblioteca cliente, usa la CLI de gcloud. El comando gcloud auth application-default login accede a gcloud para obtener credenciales predeterminadas de la aplicación con tu cuenta de usuario, lo que se debe hacer antes de llamar a la API. Se debe usar el comando gcloud auth application-default set-quota-project a fin de configurar tu proyecto para la facturación y las cuotas relacionadas con las llamadas a la API. Por lo general, este es el mismo proyecto que usa tu agente y proporcionas el ID del proyecto que creaste en los pasos anteriores.

No se debe establecer la variable de entorno GOOGLE_APPLICATION_CREDENTIALS para que las bibliotecas cliente puedan usar las credenciales predeterminadas de tu aplicación.

Para crear credenciales predeterminadas de la aplicación para tu entorno local, haz lo siguiente: 

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

Autenticación con cuentas de servicio

Las cuentas de servicio son otra opción de autenticación que solo se debe usar en entornos seguros como producción o etapa de pruebas. Una cuenta de servicio proporciona credenciales para aplicaciones, a diferencia de los usuarios finales. Las cuentas de servicio son propiedad de los proyectos, y puedes crear muchas cuentas de servicio para un proyecto. Para obtener más información, consulte:

Control de acceso con roles

Cuando una principal (cuenta de usuario, cuenta de servicio, etc.) llama a una API, Google Cloud requiere que la principal tenga los permisos correspondientes. Para otorgar permisos, puedes asignar roles a una principal. Para obtener más información, consulta la descripción general de los roles.

Si creaste tu proyecto con tu cuenta de usuario, esta tiene la rol básico de propietario para el proyecto. Este rol proporciona acceso para llamar a cualquier API del proyecto. Sin embargo, si otra cuenta creó el proyecto, es posible que debas otorgar roles a tu cuenta de usuario antes de que puedas llamar a la API.

Instala la biblioteca cliente de la API de Vision

Tienes las siguientes tres opciones para llamar a la API de Vision:

Las bibliotecas cliente están disponibles para varios lenguajes populares. Para obtener información sobre la instalación de las bibliotecas cliente, consulta Bibliotecas cliente de la API de Vision.

Limpieza

Después de configurar y probar Vision, te recomendamos borrar los recursos que creaste:

  • Te recomendamos cerrar tu proyecto.
  • Si llamaste a gcloud auth login, esto almacena las credenciales en el directorio de usuarios de tu computadora. Puedes borrar estas credenciales con la siguiente llamada: 
    gcloud auth revoke
  • Si llamaste a gcloud auth application-default login, esto almacena las credenciales en el directorio de usuarios de tu computadora. Puedes borrar estas credenciales con la siguiente llamada: 
    gcloud auth application-default revoke