Configurar el acceso a la API REST de Google Cloud Search

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Debe configurar el acceso a la API REST de Google Cloud Search antes de poder usar esta API directamente o a través de un SDK. Este documento cubre los pasos necesarios para usar la API REST de Google Cloud Search.

1. Crea un proyecto de API

Para habilitar la API, primero debe crear un proyecto de Google Cloud Platform. Este proyecto forma la base para crear, habilitar y usar todos los servicios de Google Cloud Platform (GCP), incluida 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. Abra la consola de la nube de Google .

  2. En la parte superior de la página, haga clic en a la derecha de "Google Cloud Console". Aparece un cuadro de diálogo que enumera los proyectos actuales.

  3. Haga clic en NUEVO PROYECTO . Aparece la pantalla "Nuevo proyecto".

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

  5. (opcional) Haga clic en Editar para editar el ID del proyecto. El ID del proyecto no se puede cambiar después de que se crea el proyecto, así que elija un ID que satisfaga sus necesidades durante la vida útil del proyecto.

  6. Para buscar ubicaciones para el proyecto, haga clic en EXAMINAR .

  7. Haga clic en una ubicación para su proyecto y haga clic 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 la creación y gestión de proyectos, consulte Creación y gestión de proyectos .

2. Habilite la API

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

  1. Para asegurarse de estar en el proyecto recién creado, haga clic en el icono de a la derecha del banner de Google Cloud Console y seleccione su proyecto recién creado.
  2. Haga clic en HABILITAR APIS Y SERVICIOS . Aparece la página "Bienvenido a la biblioteca API".
  3. Navegue a la API de Google Cloud Search .
  4. Haga clic en Habilitar . Aparece la página "Resumen".

Para obtener más información sobre cómo habilitar y deshabilitar las API, consulte Administrar API en Google Cloud Console.

3. Crear credenciales de cuenta de servicio

  1. En Cloud Platform Console , haga clic en Credenciales en la barra de navegación de la izquierda. Aparece la página Credencial.
  2. En la lista desplegable Crear credenciales , seleccione Cuenta de servicio . Aparece la página "Crear cuenta de servicio".
  3. Ingrese un nombre en el campo Nombre de la cuenta de servicio .
  4. (opcional) Edite el ID de la cuenta de servicio.
  5. Haz clic en Crear . Aparece una pantalla de "Permisos de cuenta de servicio".
  6. Haga clic en Continuar . Aparece la pantalla "Otorgar acceso a los usuarios a esta cuenta de servicio".
  7. Haga clic en CREAR CLAVE y haga clic en Listo . Aparece el cuadro de diálogo "Clave privada guardada en su computadora" y se descarga una copia de la clave privada en su computadora.
  8. Haga clic en Cerrar .

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

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

  1. En Cloud Platform Console , seleccione el proyecto que creó en la parte superior de la página.
  2. Haga clic en el menú de navegación a la izquierda del banner de Google Cloud Console.
  3. Haga clic en IAM y administración > Cuentas de servicio .
  4. En la lista, en "ID de cuenta de servicio", anota 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. Inicializar el soporte de terceros

Antes de que pueda llamar a cualquier otra API de Cloud Search, debe inicializar el soporte de terceros para Google Cloud Search.

Para inicializar el soporte de terceros para Cloud Search:

  1. Su proyecto de plataforma de Cloud Search contiene credenciales de cuenta de servicio. Sin embargo, en aras de inicializar el soporte de terceros, debe crear credenciales de aplicación web. Para obtener instrucciones sobre cómo crear credenciales de aplicaciones web, consulte Crear credenciales . Al completar este paso, debe tener una identificación de cliente y un archivo secreto de cliente.

  2. Utilice el área de juegos OAuth 2 de Google para obtener un token de acceso:

    1. Haga clic en configuración y marque Usuario sus propias credenciales de autenticación .
    2. Ingrese la identificación del cliente y el secreto del cliente del paso 1.
    3. Haga clic en Cerrar .
    4. En el campo de alcances, escriba https://www.googleapis.com/auth/cloud_search.settings y haga clic en Autorizar . El área de juegos de OAuth 2 devuelve un código de autorización.
    5. Haz clic en Intercambiar código de autorización para tokens . Se devuelve un token.
  3. Para inicializar el soporte de terceros para Cloud Search, use el siguiente comando curl. Asegúrese de sustituir [YOUR_ACCESS_TOKEN] con el token obtenido 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 tiene éxito, el cuerpo de la respuesta contiene una instancia de operation . Por ejemplo:

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

    Si no tiene éxito, comuníquese con el soporte de Cloud Search.

  4. Use Operations.get para verificar que el soporte de terceros esté inicializado:

    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

Estos son algunos de los siguientes pasos que puede tomar:

  1. Si planea usar Google Cloud Search con un repositorio de datos que no sea de Google, como Microsoft® SharePoint®, debe crear una fuente de datos. Para obtener instrucciones sobre cómo agregar una fuente de datos, consulte Agregar una fuente de datos para buscar .

  2. Una vez que configure su fuente de datos, puede crear y registrar un esquema para identificar cómo Google Cloud Search debe representar los datos en el repositorio.