Esta guía proporciona todos los pasos de configuración necesarios para comenzar a usar Natural Language.
Acerca de la consola de Google Cloud
La consola de Google Cloud es una IU web que sirve para aprovisionar, configurar, administrar y supervisar los sistemas que usan productos de Google Cloud. Usa la consola de Google Cloud para configurar y administrar los recursos de Natural Language.
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. y consta de los siguientes componentes:
- un conjunto de colaboradores
- API habilitadas (y otros recursos)
- herramientas de supervisión
- datos de facturación
- 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. Para obtener más información sobre los proyectos, consulta la documentación del Administrador de recursos.
En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.
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.
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
Habilite la API
Debes habilitar la API de Cloud Natural Language para tu proyecto. Para obtener más información sobre cómo habilitar las API, consulta Cómo habilitar e inhabilitar servicios.
Habilita Cloud Natural Language API.
Instala e inicializa la CLI de gcloud
Si planeas usar la API de Natural Language, debes instalar y, luego, inicializar gcloud CLI, que es conjunto de herramientas que puedes usar para administrar recursos y aplicaciones alojados en Google Cloud. Esto incluye la CLI de gcloud. En el siguiente vínculo, se proporcionan instrucciones:
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
Configura la autenticación
Cualquier aplicación cliente que use la API debe estar autenticada y tener acceso a los recursos solicitados. La forma de configurar la autenticación depende de si trabajas en un entorno de desarrollo local o configurando un entorno de producción. Para obtener más información, consulta Configura credenciales predeterminadas de la aplicación.
Selecciona las pestañas cómo planeas acceder a la API:
gcloud
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
C#
Para usar las muestras de .NET de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.
Go
Para usar las muestras de Go de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.
Java
Para usar las muestras de Java de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.
Node.js
Para usar las muestras de Node.js de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.
PHP
Para usar las muestras de PHP de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.
Python
Para usar las muestras de Python de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.
Ruby
Para usar las muestras de Ruby de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.
REST
Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
Si deseas obtener información sobre cómo configurar la autenticación para un entorno de producción, consulta Configura las credenciales predeterminadas de la aplicación para el código que se ejecuta en Google Cloud. en la documentación de autenticación de Google Cloud.
Instala la biblioteca cliente de la API de Natural Language
Tienes tres opciones para llamar a la API:
- Bibliotecas cliente compatibles con Google (recomendado)
- REST
- gRPC
Las bibliotecas cliente están disponibles para varios lenguajes populares. Para obtener información sobre cómo instalar las bibliotecas cliente, consulta Bibliotecas cliente de Cloud Natural Language.
Acerca de las funciones
No se requiere una función para acceder a la API de Cloud Natural Language. Los usuarios o las aplicaciones autenticados pueden realizar llamadas a la API, sin importar sus permisos.