Guía de inicio rápido: Configura la API de Natural Language

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.

Crear 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.

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.

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.

Enable the Cloud Natural Language API.

Enable the 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:

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

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 si configuras un entorno de producción. Para obtener más información, consulta Configura credenciales predeterminadas de la aplicación.

Select the tabs for how you plan to access the API:

gcloud

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

gcloud init

Bibliotecas cliente

Para usar bibliotecas cliente en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

  3. If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Si deseas obtener más información, consulta Configura ADC para un entorno de desarrollo local en la documentación de autenticación de Google Cloud.

REST

Para usar la API de REST en un entorno de desarrollo local, debes usar las credenciales que proporcionas a gcloud CLI.

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

    gcloud init

Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

Si deseas obtener información sobre cómo configurar la autenticación para un entorno de producción, consulta Set up Application Default Credentials for code running on 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:

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.