Configura el acceso a la API de Google Cloud Search

Debes configurar el acceso a la API de Google Cloud Search antes de que puedas usarla directamente o mediante 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, que incluyen administrar las APIs, habilitar la facturación, agregar o quitar colaboradores y administrar los permisos.

  1. Abre Google Cloud Console

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

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

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

  5. (opcional) Haz clic en Editar para editar el ID del proyecto. El ID del proyecto no se puede cambiar luego de que se crea el proyecto. Por lo tanto, elige un ID que abarque 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. Habilita la API

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

  1. Para asegurarte de que estás en el proyecto creado hace poco, haz clic en el ícono a la derecha del banner de la consola de Google Cloud y selecciona el proyecto recientemente creado.
  2. Haz clic en HABILITAR API Y SERVICIOS. Aparece la página “Te damos la bienvenida a la Biblioteca de APIs”.
  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.

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. 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 diálogo “Clave privada guardada en tu computadora” y se descargará una copia de la clave privada a 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. Cómo 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ú 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 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 que puedas llamar a otras APIs de Cloud Search, debes inicializar la compatibilidad con terceros para Google Cloud Search.

Para inicializar la compatibilidad con terceros para Cloud Search, sigue estos pasos:

  1. Tu proyecto de la plataforma de Cloud Search contiene credenciales de cuenta de servicio. Sin embargo, para inicializar la compatibilidad con terceros, debes crear credenciales de aplicación web. Si quieres obtener instrucciones para crear credenciales de aplicación web, consulta Crea credenciales. Cuando completes este paso, deberías tener un ID de cliente y un archivo de secreto de cliente.

  2. Usa OAuth 2 Playground de Google para obtener un token de acceso:

    1. Haz clic en Configuración y marca la opción Usar 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 permisos, escribe https://www.googleapis.com/auth/cloud_search.settings y haz clic en Autorizar. El campo de pruebas de OAuth 2 muestra un código de autorización.
    5. Haz clic en Intercambiar código de autorización por tokens. Se muestra un token.

  3. Para inicializar la compatibilidad con terceros para Cloud Search, usa el siguiente comando curl. Asegúrate de reemplazar [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 de forma correcta, el cuerpo de la respuesta contiene una instancia de operation. Por ejemplo:

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

    Si no lo logras, comunícate con el equipo de asistencia de Búsqueda en la nube.

  4. Usa operations.get para verificar que se haya inicializado la compatibilidad con 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.