Tutorial de primeiros passos do Google Cloud Search
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este tutorial mostra como implantar uma solução simples do Cloud Search e usa o GitHub como o repositório de dados a serem indexados. Especificamente, este tutorial consiste em dois aplicativos de exemplo:
Um conector de conteúdo, criado com o
SDK do conector do Cloud Search, usado para indexar
dados encontrados em repositórios do GitHub. Os dados indexados incluem problemas, solicitações de pull e o conteúdo do cabeçalho da ramificação padrão (master).
Um web app que usa o
widget de pesquisa
para fornecer uma interface de pesquisa personalizada.
Pré-requisitos
Este tutorial tem os seguintes pré-requisitos:
Acesso de administrador a um domínio do Google Workspace ou do Cloud Identity com a
indexação de dados de terceiros do Cloud Search ativada. Se você não conseguir acessar as configurações no painel de controle do administrador, entre em contato com o administrador do domínio ou inscreva-se no Cloud Search.
Para começar, crie um projeto do Google Cloud Platform. Esse projeto é a base para criar, ativar e usar todos os serviços do Google Cloud Platform (GCP), incluindo gerenciamento de APIs, habilitação de faturamento, adição e remoção de colaboradores e gerenciamento de permissões.
Na parte de cima da página, clique em
arrow_drop_down
à direita de "Console do Google Cloud". Será exibida uma caixa de diálogo que lista os projetos atuais.
Clique em NOVO PROJETO. A tela "Novo projeto" será exibida.
No campo Nome do projeto, digite um nome, como "SearchTutorial".
(opcional) Clique em Editar para editar o código do projeto. O código do projeto não pode ser alterado após a criação do projeto, portanto, escolha um código que atenda às suas necessidades durante a vida útil do projeto.
Para procurar locais para o projeto, clique em PROCURAR.
Clique em um local para seu projeto e em Selecionar.
Clique em CRIAR. O Console acessa a página "Painel". O projeto é criado em poucos minutos.
É necessário ativar a API Google Cloud Search e criar uma conta de serviço para conseguir as credenciais.
Na navegação à esquerda, clique em APIs e serviços.
Para garantir que você esteja no projeto mais recente, clique no ícone arrow_drop_down à direita do banner do console do Google Cloud e selecione o projeto recém-criado.
Clique em ATIVAR APIS E SERVIÇOS. A página "Olá! Esta é a Biblioteca de APIs" aparece.
Digite "API Cloud Search" no campo de pesquisa e pressione Enter. Uma lista de APIs é retornada.
Clique em API Cloud Search. A página "API Cloud Search" aparece.
Clique em ATIVAR. A página "Visão geral" será exibida.
[null,null,["Última atualização 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)"]]
