Instructivo para comenzar a usar Google Cloud Search
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este instructivo, se muestra cómo implementar una solución simple de Cloud Search y se usa GitHub como el repositorio de datos que se indexarán. Específicamente, este instructivo consta de dos aplicaciones de ejemplo:
Un conector de contenido, creado con el SDK de Cloud Search Connector, que se usa para indexar los datos que se encuentran en los repositorios de GitHub. Los datos indexados incluyen problemas, solicitudes de extracción y el contenido principal de la rama predeterminada (master).
Una app web que usa el widget de búsqueda para proporcionar una interfaz de búsqueda personalizada.
Requisitos previos
Este instructivo requiere los siguientes requisitos previos:
Acceso de administrador a un dominio de Google Workspace o Cloud Identity con la indexación de datos de terceros de Cloud Search habilitada Si no puedes ver la configuración en el panel de control del administrador, comunícate con el administrador de tu dominio o regístrate en Cloud Search.
Para comenzar, debes crear un proyecto de Google Cloud Platform. Este proyecto constituye la base para crear, habilitar y usar todos los servicios de Google Cloud Platform (GCP), que incluyen administrar las API, habilitar la facturación, agregar o quitar colaboradores y administrar los permisos.
En la parte superior de la página, haz clic en arrow_drop_down a la derecha de "Consola de Google Cloud". Aparecerá un diálogo en el que se enumeran los proyectos actuales.
Haz clic en PROYECTO NUEVO. Aparecerá la pantalla Proyecto nuevo.
En el campo Nombre del proyecto, ingresa un nombre de proyecto, como "SearchTutorial".
(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.
Para explorar las ubicaciones del proyecto, haz clic en EXPLORAR.
Haz clic en una ubicación para tu proyecto y, luego, en Seleccionar.
Haz clic en CREAR. La consola navega a la página Panel. El proyecto se crea en unos minutos.
Debes habilitar la API de Google Cloud Search y crear una cuenta de servicio para obtener las credenciales.
En la barra de navegación izquierda, haz clic en APIs & Services.
Para asegurarte de que estás en el proyecto creado recientemente, haz clic en el ícono arrow_drop_down a la derecha del banner de la consola de Google Cloud y selecciona el proyecto que acabas de crear.
Haz clic en HABILITAR API Y SERVICIOS. Aparecerá la página "Bienvenido a la Biblioteca de APIs".
Escribe "API de Cloud Search" en el campo de búsqueda y presiona Intro. Se muestra una lista de APIs.
Haz clic en API de Cloud Search. Aparecerá la página "API de Cloud Search".
Haz clic en HABILITAR. Aparecerá la página Descripción general.
[null,null,["Última actualización: 2025-08-29 (UTC)"],[],[],null,["# Google Cloud Search getting started tutorial\n\nThis tutorial shows how to deploy a simple Cloud Search solution and uses\nGitHub as the repository of data to be indexed. Specifically, this\ntutorial consists of two sample applications:\n\n- A content connector, created with the [Cloud Search Connector SDK](/workspace/cloud-search/docs/reference/sdk), used to index data found in GitHub repositories. Data indexed includes issues, pull requests, and the head content of the default branch (`master`).\n- A web app that uses the [search widget](/workspace/cloud-search/docs/guides/search-widget) to provide a customized search interface.\n\n| **Note:** The tutorial content connector is not intended to be used in production and is provided for sample purposes only. For production use, consider creating a [GitHub App](https://developer.github.com/apps/building-your-first-github-app/) to handle indexing.\n\nPrerequisites\n-------------\n\nThis tutorial requires the following prerequisites:\n\n- Administrator access to a Google Workspace or Cloud Identity domain with Cloud Search for Third Party Data Indexing enabled. If you're unable to view settings in the Admin control panel, either contact your domain administrator or [sign-up for Cloud Search](https://cloud.google.com/products/search/).\n- A [GitHub](https://github.com/) user account.\n- Java and JavaScript familarity.\n- [Java 8](http://www.oracle.com/technetwork/java/javase/downloads/index.html) or newer.\n- [Maven](http://maven.apache.org/install.html).\n- [Node.js](https://nodejs.org/) 8.11 or newer.\n\nCreate the tutorial project\n---------------------------\n\nTo start, you must create an Google Cloud Platform project. This\nproject forms the basis for creating, enabling, and using all Google Cloud\nPlatform (GCP) services, including managing APIs, enabling billing, adding and\nremoving collaborators, and managing permissions.\n\n1. Open the [Google Cloud console](https://console.cloud.google.com/).\n\n2. At the top of the page, click\n arrow_drop_down\n to the right of \"Google Cloud Console.\" A dialog listing current projects\n appears.\n\n3. Click **NEW PROJECT**. The New Project screen appears.\n\n4. In the **Project Name** field, enter a project name, such as\n \"SearchTutorial.\"\n\n5. (optional) Click **Edit** to edit the Project ID. The project ID can't be\n changed after the project is created, so choose an\n ID that meets your needs for the lifetime of the project.\n\n6. To browse locations for the project, click **BROWSE**.\n\n7. Click on a location for your project and click **Select**.\n\n8. Click **CREATE**. The console navigates to the Dashboard page. The project\n is created within a few minutes.\n\nFor further information on creating and managing projects, refer to\n[Creating and Managing Projects](https://support.google.com/cloud#topic=6158848).\n\nEnable the API\n--------------\n\nYou need to enable the Google Cloud Search API and create a service account to\nobtain credentials.\n\n1. In the left navigation, click **APIs \\& Services**.\n2. To ensure you are on the newly created project, click the arrow_drop_down icon to the right of the Google Cloud console banner and select your newly-created project.\n3. Click **ENABLE APIS AND SERVICES**. The \"Welcome to API Library\" page appears.\n4. Type \"Cloud Search API\" in the search field and press **return**. A list of APIs is returned.\n5. CLick **Cloud Search API**. The \"Cloud Search API\" page appears.\n6. Click **ENABLE**. The Overview page appears.\n\nFor further information on enabling and disabling APIs, refer to\n[Manage APIs in the Google Cloud console](https://support.google.com/cloud/answer/6326510)\n| **Note:** Different Google Cloud Search APIs require different accounts to execute (admin, service, and user). For further information, refer to the [reference documentation](/workspace/cloud-search/docs/reference) for the method you want to call.\n\nClone the tutorial repository\n-----------------------------\n\nTo clone the sample repository, run the following command: \n\n git clone https://github.com/googleworkspace/cloud-search-samples.git\n\n[Next](/workspace/cloud-search/docs/tutorials/end-to-end/setup-connector)"]]
