با مجموعهها، منظم بمانید ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این آموزش نحوه استقرار یک راه حل ساده Cloud Search را نشان می دهد و از GitHub به عنوان مخزن داده برای فهرست بندی استفاده می کند. به طور خاص، این آموزش شامل دو نمونه برنامه کاربردی است:
یک رابط محتوا، ایجاد شده با Cloud Search Connector SDK ، که برای فهرست کردن داده‌های موجود در مخازن GitHub استفاده می‌شود. داده‌های نمایه‌شده شامل مسائل، درخواست‌های کششی و محتوای سر شاخه پیش‌فرض ( master ) است.
یک برنامه وب که از ویجت جستجو برای ارائه یک رابط جستجوی سفارشی استفاده می کند.
پیش نیازها
این آموزش به پیش نیازهای زیر نیاز دارد:
دسترسی سرپرست به Google Workspace یا دامنه Cloud Identity با فعال بودن Cloud Search for Third Data Indexing. اگر نمی توانید تنظیمات را در کنترل پنل مدیریت مشاهده کنید، با سرپرست دامنه خود تماس بگیرید یا برای جستجوی ابری ثبت نام کنید .
برای شروع، باید یک پروژه Google Cloud Platform ایجاد کنید. این پروژه اساس ایجاد، فعال کردن و استفاده از همه سرویس‌های Google Cloud Platform (GCP) از جمله مدیریت APIها، فعال کردن صورت‌حساب، افزودن و حذف همکاران و مدیریت مجوزها را تشکیل می‌دهد.
در بالای صفحه، روی arrow_drop_down در سمت راست "Google Cloud Console" کلیک کنید. گفتگوی لیست پروژه های فعلی ظاهر می شود.
روی NEW PROJECT کلیک کنید. صفحه New Project ظاهر می شود.
در قسمت Project Name ، نام پروژه مانند «SearchTutorial» را وارد کنید.
(اختیاری) برای ویرایش شناسه پروژه روی Edit کلیک کنید. شناسه پروژه پس از ایجاد پروژه قابل تغییر نیست، بنابراین شناسه ای را انتخاب کنید که نیازهای شما را برای طول عمر پروژه برآورده کند.
برای مرور مکان‌های پروژه، روی BROWSE کلیک کنید.
روی یک مکان برای پروژه خود کلیک کنید و روی انتخاب کلیک کنید.
روی CREATE کلیک کنید. کنسول به صفحه داشبورد هدایت می شود. پروژه در عرض چند دقیقه ایجاد می شود.
شما باید Google Cloud Search API را فعال کنید و یک حساب کاربری برای دریافت اعتبار ایجاد کنید.
در پیمایش سمت چپ، روی APIs & Services کلیک کنید.
برای اطمینان از اینکه در پروژه جدید ایجاد شده هستید، روی نماد arrow_drop_down در سمت راست بنر کنسول Google Cloud کلیک کنید و پروژه تازه ایجاد شده خود را انتخاب کنید.
روی ENABLE APIS AND SERVICES کلیک کنید. صفحه "Welcome to API Library" ظاهر می شود.
"Cloud Search API" را در قسمت جستجو تایپ کنید و بازگشت را فشار دهید. لیستی از API ها برگردانده می شود.
روی Cloud Search API کلیک کنید. صفحه "Cloud Search API" ظاهر می شود.
تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[],[],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)"]]
