Configura el acceso a la API de Google Cloud Search

Debes configurar el acceso a la API de Google Cloud Search antes de poder usar esta API directamente o a través de un SDK. Este documento abarca 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. Esta proyecto constituye la base para crear, habilitar y usar todas las herramientas servicios, como administrar APIs, habilitar la facturación, agregar y quitar colaboradores y administrar permisos.

  1. Abre Google Cloud Console

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

  3. Haz clic en PROYECTO NUEVO. El "Proyecto nuevo" aparecerá una pantalla.

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

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

Para obtener más información sobre cómo inhabilitar y habilitar 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 panel de navegación izquierdo. Aparecerá la página Credencial.
  2. En la lista desplegable Crear credenciales, selecciona Cuenta de servicio. El “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. Un permiso de la cuenta de servicio aparecerá una pantalla.
  6. Haz clic en Continuar. La opción “Otorga a usuarios acceso a esta cuenta de servicio” pantalla .
  7. Haz clic en CREAR CLAVE y, luego, en Listo. Una "Clave privada guardada en tu computadora" en el cuadro de diálogo y se descargará una copia de la clave privada en tu que ya almacenaste 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. Identifica la dirección de correo electrónico

  1. Desde 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 cuenta de servicio", toma nota del correo electrónico generado dirección IP 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 asistencia de terceros

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

Para inicializar la compatibilidad de terceros con 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 asistencia de terceros, debes crear sitios web credenciales de aplicaciones. Obtén instrucciones para crear una aplicación web credenciales, consulta Crea credenciales. Después de completar este paso, deberías tener un ID de cliente y un archivo de secreto del 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 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 permisos, escribe https://www.googleapis.com/auth/cloud_search.settings. y haz clic en Autorizar. OAuth 2 Playground 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 asistencia de terceros para Cloud Search, usa el siguiente comando curl: kubectl. 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 el proceso es satisfactorio, el cuerpo de la respuesta contiene una instancia de operation Por ejemplo:

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

    Si el problema persiste, comunícate con el equipo de asistencia de Cloud Search.

  4. Usa operations.get para verificar que se inicializa la asistencia 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 del tercero, contiene los el campo done se estableció 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.