Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce tutoriel explique comment déployer une solution Cloud Search simple et utilise GitHub comme dépôt de données à indexer. Plus précisément, ce tutoriel se compose de deux exemples d'applications :
Connecteur de contenu créé avec le SDK Cloud Search Connector et utilisé pour indexer les données trouvées dans les dépôts GitHub. Les données indexées incluent les problèmes, les requêtes d'extraction et le contenu principal de la branche par défaut (master).
Une application Web qui utilise le widget Recherche pour fournir une interface de recherche personnalisée.
Prérequis
Ce tutoriel requiert les prérequis suivants :
Un accès administrateur à un domaine Google Workspace ou Cloud Identity avec la fonctionnalité Cloud Search pour l'indexation de données tierces activée. Si vous ne parvenez pas à afficher les paramètres dans le panneau de configuration de l'administrateur, contactez l'administrateur de votre domaine ou inscrivez-vous à Cloud Search.
Pour commencer, vous devez créer un projet Google Cloud Platform. Ce projet constitue la base permettant de créer, d'activer et d'utiliser tous les services Google Cloud Platform (GCP), entre autres pour gérer les API, activer la facturation, ajouter ou exclure des collaborateurs et gérer les autorisations.
En haut de la page, cliquez sur arrow_drop_down à droite de "Console Google Cloud". Une boîte de dialogue répertoriant les projets en cours apparaît.
Cliquez sur NOUVEAU PROJET. L'écran "Nouveau projet" s'affiche.
Dans le champ Nom du projet, saisissez un nom de projet, par exemple "SearchTutorial".
(Facultatif) Cliquez sur Modifier pour modifier l'ID du projet. Vous ne pourrez plus modifier cet ID une fois le projet créé, donc choisissez un ID répondant à vos besoins pour toute la durée de vie du projet.
Pour parcourir les emplacements du projet, cliquez sur PARCOURIR.
Cliquez sur un emplacement pour votre projet, puis sur Sélectionner.
Cliquez sur CRÉER. La console vous redirige vers la page "Tableau de bord". Le projet est créé en quelques minutes.
Vous devez activer l'API Google Cloud Search et créer un compte de service pour obtenir des identifiants.
Dans le volet de navigation de gauche, cliquez sur API et services.
Pour vérifier que vous êtes bien dans le projet nouvellement créé, cliquez sur l'icône arrow_drop_down à droite de la bannière de la console Google Cloud, puis sélectionnez le projet que vous venez de créer.
Cliquez sur ACTIVER DES API ET DES SERVICES. La page "Bienvenue dans la bibliothèque d'API" s'affiche.
Saisissez "API Cloud Search" dans le champ de recherche, puis appuyez sur Entrée. Une liste d'API est renvoyée.
Cliquez sur API Cloud Search. La page "API Cloud Search" s'affiche.
Cliquez sur ACTIVER. La page "Vue d'ensemble" s'affiche.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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)"]]
