Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu eğitimde, basit bir Cloud Search çözümünün nasıl dağıtılacağı gösterilmekte ve dizine eklenecek verilerin deposu olarak GitHub kullanılmaktadır. Bu eğitimde özellikle iki örnek uygulama yer almaktadır:
GitHub depolarında bulunan verileri dizine eklemek için Cloud Search Connector SDK ile oluşturulan bir içerik bağlayıcısı. Dizine eklenen veriler arasında sorunlar, çekme istekleri ve varsayılan dalın (master) baş içeriği yer alır.
Özelleştirilmiş bir arama arayüzü sağlamak için arama widget'ını kullanan bir web uygulaması.
Ön koşullar
Bu eğitim için aşağıdaki ön koşullar gereklidir:
Üçüncü taraf verilerini dizine ekleme için Cloud Search'ün etkin olduğu bir Google Workspace veya Cloud Identity alanına yönetici erişimi Yönetici kontrol panelinde ayarları görüntüleyemiyorsanız alan yöneticinizle iletişime geçin veya Cloud Search'e kaydolun.
Başlamak için bir Google Cloud Platform projesi oluşturmanız gerekir. Bu proje; API'leri yönetme, faturalandırmayı etkinleştirme, ortak çalışanları ekleme ve kaldırma, izinleri yönetme dahil olmak üzere tüm Google Cloud Platform (GCP) hizmetlerini oluşturma, etkinleştirme ve kullanma işlemlerinin temelini oluşturur.
Sayfanın üst kısmında, "Google Cloud Console"un sağındaki
arrow_drop_down
simgesini tıklayın. Mevcut projelerin listelendiği bir iletişim kutusu açılır.
YENİ PROJE'yi tıklayın. Yeni Proje ekranı görünür.
Proje Adı alanına "SearchTutorial" gibi bir proje adı girin.
(İsteğe bağlı) Proje kimliğini düzenlemek için Düzenle'yi tıklayın. Proje oluşturulduktan sonra proje kimliği değiştirilemez. Bu nedenle, proje süresince ihtiyaçlarınızı karşılayacak bir kimlik seçin.
Projenin konumlarına göz atmak için GÖZ AT'ı tıklayın.
Projeniz için bir konumu ve Seç'i tıklayın.
OLUŞTUR'u tıklayın. Konsol, Kontrol Paneli sayfasına gider. Proje birkaç dakika içinde oluşturulur.
Proje oluşturma ve yönetme hakkında daha fazla bilgi için Proje Oluşturma ve Yönetme başlıklı makaleyi inceleyin.
API'yi etkinleştirme
Kimlik bilgilerini almak için Google Cloud Search API'yi etkinleştirmeniz ve bir hizmet hesabı oluşturmanız gerekir.
Soldaki gezinme menüsünde API'ler ve Hizmetler'i tıklayın.
Yeni oluşturulan projede olduğunuzdan emin olmak için Google Cloud Console banner'ının sağındaki arrow_drop_down simgesini tıklayın ve yeni oluşturduğunuz projeyi seçin.
API'LERİ VE HİZMETLERİ ETKİNLEŞTİR'i tıklayın. "API Kitaplığına hoş geldiniz" sayfası görünür.
Arama alanına "Cloud Search API" yazıp return tuşuna basın. API listesi döndürülür.
Cloud Search API'yi tıklayın. "Cloud Search API" sayfası görünür.
ETKİNLEŞTİR'i tıklayın. Genel Bakış sayfası görünür.
[null,null,["Son güncelleme tarihi: 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)"]]
