Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo tutorial mostra come eseguire il deployment di una semplice soluzione Cloud Search e utilizza
GitHub come repository dei dati da indicizzare. Nello specifico, questo
tutorial è composto da due applicazioni di esempio:
Un connettore di contenuti, creato con l'SDK Cloud Search Connector, utilizzato per indicizzare i dati trovati nei repository GitHub. I dati indicizzati includono problemi, richieste pull
e i contenuti dell'intestazione del ramo predefinito (master).
Un'app web che utilizza il
widget di ricerca
per fornire un'interfaccia di ricerca personalizzata.
Prerequisiti
Questo tutorial richiede i seguenti prerequisiti:
Accesso amministratore a un dominio Google Workspace o Cloud Identity con
l'indicizzazione dei dati di terze parti di Cloud Search abilitata. Se non riesci a visualizzare
le impostazioni nel pannello di controllo amministrativo, contatta l'amministratore di dominio
o registrati a Cloud Search.
Per iniziare, devi creare un progetto Google Cloud. Questo
progetto è la base per creare, abilitare e utilizzare tutti i servizi Google Cloud
Platform (GCP), tra cui gestione delle API, attivazione della fatturazione, aggiunta e
rimozione di collaboratori e gestione delle autorizzazioni.
Nella parte superiore della pagina, fai clic su
arrow_drop_down
a destra di "Console Google Cloud". Viene visualizzata una finestra di dialogo che elenca i progetti attuali.
Fai clic su NUOVO PROGETTO. Viene visualizzata la schermata Nuovo progetto.
Nel campo Nome progetto, inserisci un nome per il progetto, ad esempio
"SearchTutorial".
(Facoltativo) Fai clic su Modifica per modificare l'ID progetto. L'ID progetto non può essere
modificato dopo la creazione del progetto, quindi scegli un
ID che soddisfi le tue esigenze per tutta la durata del progetto.
Per sfogliare le posizioni del progetto, fai clic su SFOGLIA.
Fai clic su una posizione per il progetto e poi su Seleziona.
Fai clic su CREA. La console passa alla pagina Dashboard. Il progetto
viene creato in pochi minuti.
Per ulteriori informazioni sulla creazione e sulla gestione dei progetti, consulta la pagina
Creare e gestire progetti.
Abilita l'API
Devi abilitare l'API Google Cloud Search e creare un service account per ottenere le credenziali.
Nel riquadro di navigazione a sinistra, fai clic su API e servizi.
Per assicurarti di trovarti nel progetto appena creato, fai clic sull'icona
arrow_drop_down a destra del
banner della console Google Cloud e seleziona il progetto appena creato.
Fai clic su ABILITA API E SERVIZI. Viene visualizzata la pagina "Ti diamo il benvenuto nella libreria di API".
Digita "API Cloud Search" nel campo di ricerca e premi Invio. Viene restituito un elenco
di API.
Fai clic su API Cloud Search. Viene visualizzata la pagina "API Cloud Search".
Fai clic su ABILITA. Viene visualizzata la pagina Panoramica.
[null,null,["Ultimo aggiornamento 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)"]]
