Configura el acceso a la API de Google Cloud Search

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

1. Crea un proyecto de API

Para habilitar la API, primero debes crear un proyecto de Google Cloud. Este proyecto constituye la base para crear, habilitar y usar todos los servicios de Google Cloud, incluidos la administración de las API, la habilitación de la facturación, la adición y eliminación de colaboradores, y la administración de permisos.

1. Abre la consola de Google Cloud

2. En la parte superior de la página, haz clic en a la derecha de “Google Cloud Console”. Aparecerá un diálogo en el que se enumeran los proyectos actuales.

3. Haz clic en PROYECTO NUEVO. Aparecerá la pantalla "New Project".

4. Ingresa un nombre de proyecto en el campo Nombre del proyecto.

5. (Opcional) Haga clic en Editar para modificar el ID del proyecto. El ID del proyecto no se puede cambiar después de que se crea, así que elige un ID que satisfaga tus necesidades durante todo el ciclo de vida del proyecto.

6. Para explorar las ubicaciones del proyecto, haz clic en EXPLORAR.

7. Haz clic en una ubicación para tu proyecto y, luego, en Seleccionar.

8. Haz clic en Crear. La consola navega a la página Panel. El proyecto se crea en unos minutos.

Para obtener más información sobre crear y administrar proyectos, consulta Cómo crear y administrar proyectos.

2. Cómo habilitar la API

Debes habilitar la API de Google Cloud Search y crear una cuenta de servicio para obtener credenciales.

1. Para asegurarte de que estás en el proyecto recién creado, haz clic en el ícono a la derecha del banner de la consola de Google Cloud y selecciona el proyecto recién creado.
2. Haz clic en HABILITAR API Y SERVICIOS. Aparecerá la página "Welcome to API Library".
3. Navega a la API de Google Cloud Search.
4. Haz clic en Habilitar. Aparecerá la página "Resumen".

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

Nota: Las diferentes API de Cloud Search requieren cuentas diferentes para ejecutarse (administrador, servicio y usuario). Si quieres obtener más información, consulta la documentación de referencia del método al que deseas llamar.

3. Crea credenciales de cuenta de servicio

1. En la consola de Google Cloud, haz clic en Credenciales en el panel de navegación izquierdo. Aparecerá la página Credencial.
2. En la lista desplegable Crear credenciales, selecciona Cuenta de servicio. Aparecerá la página “Crear cuenta de servicio”.
3. Ingresa un nombre en el campo Nombre de cuenta de servicio.
4. (opcional) Edita el ID de cuenta de servicio.
5. Haz clic en Crear. Aparecerá la pantalla "Permisos de la cuenta de servicio".
6. Haz clic en Continuar. Aparecerá la pantalla “Otorgar a los usuarios acceso a esta cuenta de servicio”.
7. Haz clic en CREAR CLAVE y, luego, en Listo. Aparecerá el cuadro de diálogo “Se guardó la clave privada en tu computadora” y se descargará una copia de la clave privada en tu computadora.
8. Haz clic en Cerrar.

Para obtener más información sobre las cuentas de servicio, consulta Cuentas de servicio, aplicaciones web y aplicaciones instaladas

4. Identificar la dirección de correo electrónico

1. En la consola de Google Cloud, selecciona el proyecto que creaste en la parte superior de la página.
2. Haz clic en el Menú de navegación a la izquierda del banner de la consola de Google Cloud.
3. Haz clic en IAM y Administrador > Cuentas de servicio.
4. En la lista, en “ID de la cuenta de servicio”, toma nota de la dirección de correo electrónico generada que identifica la cuenta de servicio que configuraste. Esta dirección de correo electrónico se usa cuando se agrega una fuente de datos a Cloud Search.

5. Inicializa la compatibilidad con terceros

Antes de llamar a cualquier otra API de Cloud Search, debes inicializar la compatibilidad de terceros para Google Cloud Search.

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

Para inicializar la compatibilidad de terceros con Cloud Search, haz lo siguiente:

1. Tu proyecto de plataforma de Cloud Search contiene credenciales de cuenta de servicio. Sin embargo, a fin de inicializar la asistencia de terceros, debes crear credenciales de aplicación web. Si quieres obtener instrucciones para crear credenciales de aplicación web, consulta Crea credenciales. Después de completar este paso, debes tener un ID de cliente y un archivo del secreto del cliente.

2. Usa la zona de pruebas de OAuth 2 de Google para obtener un token de acceso:

   1. Haz clic en la configuración y marca la opción Usa tus propias credenciales de autenticación.
   2. Ingresa el ID de cliente y el secreto del cliente del paso 1.
   3. Haz clic en Cerrar.
   4. En el campo de alcances, escribe https://www.googleapis.com/auth/cloud_search.settings y haz clic en Autorizar. La zona de pruebas de OAuth 2 muestra un código de autorización.
   5. Haz clic en Intercambiar código de autorización para tokens. Se muestra un token.

3. Para inicializar la compatibilidad de terceros con Cloud Search, usa el siguiente comando curl. Asegúrate de sustituir [YOUR_ACCESS_TOKEN] por el token que obtuviste en el paso 2.

   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 contendrá una instancia de operation. Por ejemplo:

   {
   name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
   }
   

   Si no tiene éxito, comunícate con el equipo de asistencia de Cloud Search.

4. Usa operations.get para verificar que se haya inicializado la compatibilidad de terceros:

   curl \
   'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
   [YOUR_API_KEY]' \
   --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
   --header 'Accept: application/json' \
   --compressed
   

   Cuando se completa la inicialización de terceros, contiene el campo done establecido en true. Por ejemplo:

   {
   name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
   done: true
   }
   

Próximos pasos

Aquí hay algunos pasos que puedes seguir:

1. Si planeas usar Google Cloud Search con un repositorio de datos que no es de Google, como Microsoft® SharePoint®, debes crear una fuente de datos. Para obtener instrucciones sobre cómo agregar una fuente de datos, consulta Agrega una fuente de datos a la búsqueda.

2. Cuando hayas configurado tu fuente de datos, podrás crear y registrar un esquema para identificar cómo Google Cloud Search debe representar los datos del repositorio.