Configura el acceso a la API de Google Cloud Search

Debes configurar el acceso a la API de Google Cloud Search antes de usarla directamente o a través de un SDK. En este documento, se explican los pasos necesarios para la API de Cloud Search API REST.

1. Crea un proyecto de API

Para habilitar la API, primero crea un proyecto de Google Cloud. Este proyecto es la base para usar los servicios de Google Cloud, administrar APIs y configurar permisos.

1. Abre Google Cloud Console
2. Haz clic en el menú desplegable del proyecto a la derecha de "Consola de Google Cloud" y selecciona PROYECTO NUEVO.
3. Ingresa un nombre en el campo Nombre del proyecto.
4. (Opcional) Haz clic en Editar para cambiar el ID del proyecto. No podrás cambiar este ID después de crearlo.
5. Haz clic en EXPLORAR para elegir una ubicación y, luego, en Seleccionar.
6. Haz clic en Crear. Por lo general, el proyecto está listo en cuestión de minutos.

Para obtener más información, consulta Crea y administra proyectos.

2. Habilita la API

Habilita la API de Cloud Search y crea una cuenta de servicio para obtener credenciales.

1. Selecciona tu proyecto nuevo en el menú desplegable del banner de la consola de Google Cloud.
2. Haz clic en HABILITAR API Y SERVICIOS.
3. Busca y selecciona la API de Google Cloud Search.
4. Haz clic en Habilitar.

Para obtener más información, consulta Administra las APIs en la consola de Google Cloud.

Nota: Los diferentes métodos de la API de Cloud Search requieren diferentes tipos de cuentas (administrador, servicio o usuario). Consulta la documentación de referencia para obtener más detalles.

3. Crea credenciales de cuenta de servicio

1. En la consola de Google Cloud, haz clic en Credenciales en el menú de navegación de la izquierda.
2. Selecciona Cuenta de servicio en el menú desplegable Crear credenciales.
3. Ingresa un nombre en el campo Nombre de cuenta de servicio.
4. (Opcional) Edita el ID de la cuenta de servicio.
5. Haz clic en Crear y continuar.
6. Haz clic en Listo para acceder a la lista de "Cuentas de servicio".
7. Haz clic en el correo electrónico de tu nueva cuenta de servicio y, luego, selecciona la pestaña Claves.
8. Haz clic en AGREGAR CLAVE > Crear clave nueva.
9. Selecciona JSON y haz clic en Crear. La clave privada se descargará en tu computadora.

Para obtener más información, consulta Cuentas de servicio.

4. Identifica el correo electrónico de la cuenta de servicio

1. En la consola de Google Cloud, selecciona tu proyecto.
2. Haz clic en el menú de navegación > IAM y administración > Cuentas de servicio.
3. Toma nota de la dirección de correo electrónico de tu cuenta de servicio. Lo necesitas para agregar una fuente de datos a Cloud Search.

5. Inicializa la asistencia de terceros

Inicializa la compatibilidad con terceros para Google Cloud Search antes de llamar a cualquier otra API de Cloud Search.

Nota: Si completaste el instructivo de Cloud Search, ya inicializaste la compatibilidad con terceros y puedes omitir este paso.

Para inicializar la asistencia de terceros, haz lo siguiente:

1. Crea credenciales de aplicación web en tu proyecto de la plataforma de Cloud Search. Consulta Crea credenciales. Necesitas el ID de cliente y el secreto del cliente.
2. Obtén un token de acceso con OAuth 2.0 Playground:
   1. Haz clic en Configuración de OAuth 2.0 (ícono de configuración) y marca la opción Usar tus propias credenciales de OAuth.
   2. Ingresa tu ID de cliente y tu secreto del cliente.
   3. En el campo de los alcances, ingresa https://www.googleapis.com/auth/cloud_search.settings y haz clic en Autorizar APIs.
   4. Haz clic en Intercambiar código de autorización para tokens.

3. Ejecuta este comando curl y reemplaza [YOUR_ACCESS_TOKEN] por tu token:

   curl --request POST \
   'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
     --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '{}' \
     --compressed
   

   Si se ejecuta correctamente, el cuerpo de la respuesta incluye un operation. Si falla, comunícate con el equipo de asistencia de Cloud Search.

4. Usa operations.get para verificar la inicialización:

   curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed
   

   La inicialización se completa cuando done es true.

Próximos pasos

1. Para usar Cloud Search con un repositorio que no es de Google, como Microsoft® SharePoint®, debes crear una fuente de datos. Consulta Agrega una fuente de datos a la búsqueda.
2. Después de configurar tu fuente de datos, crea y registra un esquema para identificar cómo Cloud Search representa tus datos.