تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا البرنامج التعليمي كيفية نشر حلّ بسيط في Cloud Search، ويستخدم GitHub كمستودع للبيانات التي سيتم فهرستها. على وجه التحديد، يتألف هذا البرنامج التعليمي من تطبيقَين نموذجيَين:
موصِّل محتوى تم إنشاؤه باستخدام حزمة تطوير البرامج (SDK) لموصل Cloud Search، ويُستخدم لفهرسة البيانات المتوفّرة في مستودعات GitHub. تشمل البيانات المفهرسة المشاكل وطلبات الدمج ومحتوى الرأس للفرع التلقائي (master).
تطبيق ويب يستخدم أداة البحث لتوفير واجهة بحث مخصّصة.
المتطلبات الأساسية
يتطلّب هذا البرنامج التعليمي توفّر المتطلبات الأساسية التالية:
يجب أن يكون المشرف لديه إذن الوصول إلى نطاق Google Workspace أو Cloud Identity مع تفعيل ميزة "فهرسة البيانات التابعة لجهات خارجية" في Cloud Search. إذا لم تتمكّن من عرض الإعدادات في "لوحة تحكّم المشرف"، يُرجى التواصل مع مشرف النطاق أو الاشتراك في Cloud Search.
للبدء، عليك إنشاء مشروع على Google Cloud Platform. يشكّل هذا المشروع الأساس لإنشاء جميع خدمات Google Cloud Platform (GCP) وتفعيلها واستخدامها، بما في ذلك إدارة واجهات برمجة التطبيقات وتفعيل الفوترة وإضافة المتعاونين وإزالتهم وإدارة الأذونات.
عليك تفعيل واجهة برمجة التطبيقات Google Cloud Search API وإنشاء حساب خدمة للحصول على بيانات الاعتماد.
في شريط التنقّل الأيمن، انقر على واجهات برمجة التطبيقات والخدمات.
للتأكّد من أنّك في المشروع الذي تم إنشاؤه حديثًا، انقر على الرمز arrow_drop_down على يسار بانر Google Cloud Console واختَر مشروعك الذي تم إنشاؤه حديثًا.
انقر على تفعيل واجهات برمجة التطبيقات والخدمات. ستظهر صفحة "مرحبًا بك في مكتبة واجهة برمجة التطبيقات".
اكتب "Cloud Search API" في حقل البحث واضغط على Return. يتم عرض قائمة بواجهات برمجة التطبيقات.
انقر على واجهة برمجة تطبيقات Cloud Search. ستظهر صفحة "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,["This 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\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\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\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\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)"]]
