En esta página, se muestra cómo comenzar a usar las bibliotecas cliente de Cloud para la API de Vision. Obtén más información sobre las bibliotecas cliente para las API de Cloud, incluidas las bibliotecas cliente de las API de Google anteriores en Explicación de las bibliotecas cliente.
Instala la biblioteca cliente
C#
Para obtener más información, consulta Configura un entorno de desarrollo de C#.
Si usas Visual Studio 2017 o una versión posterior, abre la ventana del administrador de paquetes de Nuget y escribe lo siguiente:Install-Package Google.Apis
Si usas las herramientas de interfaz de línea de comandos de .NET Core para instalar tus dependencias, ejecuta el siguiente comando:
dotnet add package Google.Apis
Comienza a usarlo
Para obtener más información, consulta Configura un entorno de desarrollo de Go.
go get -u cloud.google.com/go/vision/apiv1
Java
Para obtener más información, consulta Configura un entorno de desarrollo de Java.
Si usas Maven, agrega lo siguiente al archivo pom.xml
. Para obtener más información sobre las BOM, consulta Las bibliotecas de BOM de Google Cloud Platform.
Si usas Gradle, agrega lo siguiente a las dependencias:
Si usas sbt, agrega lo siguiente a las dependencias:
Si usas IntelliJ o Eclipse, puedes agregar bibliotecas cliente a tu proyecto mediante los siguientes complementos de IDE:
Los complementos brindan funcionalidades adicionales, como administración de claves para las cuentas de servicio. Consulta la documentación de cada complemento para obtener más detalles.
Node.js
Para obtener más información, consulta Configura un entorno de desarrollo de Node.js.
npm install --save @google-cloud/vision
PHP
Para obtener más información, consulta PHP en Google Cloud.
composer require google/apiclient
Python
Para obtener más información, consulta Configura un entorno de desarrollo de Python.
pip install --upgrade google-cloud-vision
Ruby
Para obtener más información, consulta Cómo configurar un entorno de desarrollo en Ruby.
gem install google-api-client
Cómo configurar la autenticación
Si quieres ejecutar la biblioteca cliente, primero debes configurar la autenticación. Para ello, crea una cuenta de servicio y configura una variable de entorno. Sigue los pasos que se indican a continuación a fin de configurar la autenticación. Para obtener más información sobre otras maneras de autentificar, consulta la documentación de autenticación de GCP.
Cloud Console
Crea una cuenta de servicio:
-
En Cloud Console, ve a la página Crear cuenta de servicio.
Ir a Crear cuenta de servicio - Selecciona un proyecto
-
Ingresa un nombre en el campo Nombre de cuenta de servicio. Cloud Console completa el campo ID de cuenta de servicio con este nombre.
En el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo,
Service account for quickstart
. -
Haz clic en Listo para terminar de crear la cuenta de servicio.
No cierres la ventana del navegador. La usarás en la próxima tarea.
Para crear una clave de cuenta de servicio, haz lo siguiente:
- En Cloud Console, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
- Haz clic en Claves.
- Haz clic en Agregar clave y, luego, en Crear clave nueva.
- Haga clic en Crear. Se descargará un archivo de claves JSON a tu computadora.
- Haga clic en Cerrar.
Línea de comandos
Puedes ejecutar los siguientes comandos con el SDK de Cloud en tu máquina local o en Cloud Shell.
-
Crea la cuenta de servicio. Reemplaza NAME por un nombre para la cuenta de servicio.
gcloud iam service-accounts create NAME
-
Genera el archivo de claves. Reemplaza FILE_NAME por un nombre para el archivo de claves.
gcloud iam service-accounts keys create FILE_NAME.json --iam-account=NAME@PROJECT_ID.iam.gserviceaccount.com
Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS
para proporcionar credenciales de autenticación al código de la aplicación.
Reemplaza [PATH] por la ruta de acceso del archivo JSON que contiene la clave de tu cuenta de servicio. Esta variable solo se aplica a la sesión actual de shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.
Linux o macOS
export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
Por ejemplo:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"
Windows
Con PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
Por ejemplo:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"
Con el símbolo del sistema:
set GOOGLE_APPLICATION_CREDENTIALS=[PATH]
Usa la biblioteca cliente
En el siguiente ejemplo, se muestra cómo usar la biblioteca cliente.
Comienza a usarlo
Antes de probar este código de muestra, sigue las instrucciones de configuración para Go que se encuentran en la Guía de inicio rápido de Vision sobre cómo usar las bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Vision para Go.
Java
Antes de probar este código de muestra, sigue las instrucciones de configuración para Java que se encuentran en la Guía de inicio rápido de Vision sobre cómo usar las bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Vision para Java.
Node.js
Antes de probar este código de muestra, sigue las instrucciones de configuración para Node.js que se encuentran en la Guía de inicio rápido de Vision sobre cómo usar las bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Vision para Node.js.
Python
Antes de probar este código de muestra, sigue las instrucciones de configuración para Python que se encuentran en la Guía de inicio rápido de Vision sobre cómo usar las bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Vision para Python.
Recursos adicionales
C#
Go
Java
Node.js
PHP
Python
Ruby
Bibliotecas cliente adicionales
Además de las bibliotecas que se muestran arriba, Spring Cloud GCP está disponible para las aplicaciones de Java. La API de Spring Vision te ayuda a usar Cloud Vision en cualquier aplicación que se compile con Spring Framework.
Para comenzar, aprende a agregar Spring Cloud Vision a tu aplicación.
Pruébalo tú mismo
Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de la API de Cloud Vision en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
Probar la API de Cloud Vision gratis