توضِّح صفحة الدليل التعليمي لخدمة Google Cloud Search هذه كيفية إعداد تطبيق بحث مخصّص باستخدام أداة البحث القابلة للتضمين. للبدء من بداية هذا الدليل التوجيهي، راجِع الدليل التوجيهي لبدء استخدام Cloud Search.
تثبيت التبعيات
إذا كان الموصِّل لا يزال يُفهرس المستودع، افتح وحدة تحكّم جديدة واستمرّ من هناك.
من سطر الأوامر، غيِّر الدليل إلى
cloud-search-samples/end-to-end/search-interface
.لتنزيل التبعيات المطلوبة لتشغيل خادم الويب، شغِّل الأمر التالي:
npm install
إنشاء بيانات اعتماد تطبيق البحث
يتطلّب أداة الربط بيانات اعتماد حساب الخدمة لاستدعاء واجهات برمجة تطبيقات Cloud Search. لإنشاء بيانات الاعتماد:
ارجع إلى Google Cloud Console.
في شريط التنقّل الأيمن، انقر على بيانات الاعتماد.
من القائمة المنسدلة إنشاء بيانات اعتماد، اختَر معرِّف عميل OAuth. تظهر صفحة "إنشاء معرِّف عميل OAuth".
(اختياري). إذا لم يسبق لك ضبط شاشة الموافقة، انقر على ضبط شاشة الموافقة. ستظهر لك شاشة "طلب الموافقة المتعلّقة ببروتوكول OAuth".
انقر على داخلي ثم على إنشاء. تظهر شاشة "طلب الموافقة المتعلّقة ببروتوكول OAuth" أخرى.
املأ الحقول المطلوبة. للحصول على مزيد من التعليمات، يُرجى الرجوع إلى قسم موافقة المستخدم في إعداد OAuth 2.0.
انقر على القائمة المنسدلة نوع التطبيق واختَر تطبيق الويب.
في حقل الاسم، أدخِل "tutorial".
في حقل مصادر JavaScript المسموح بها، انقر على إضافة معرّف الموارد المنتظم (URI). سيظهر حقل "عناوين URL" فارغًا.
في حقل عناوين URL، أدخِل
http://localhost:8080
.انقر على إنشاء. تظهر شاشة "تم إنشاء عميل OAuth".
سجِّل معرّف العميل. تُستخدَم هذه القيمة لتحديد التطبيق عند طلب تفويض المستخدم باستخدام OAuth2. لا يلزم إدخال مفتاح سر العميل لإجراء هذا التنفيذ.
انقر على موافق.
إنشاء تطبيق البحث
بعد ذلك، أنشئ تطبيق بحث في "وحدة تحكّم المشرف". تطبيق البحث هو تمثيل افتراضي لواجهة البحث وإعداداته الافتراضية.
- ارجع إلى وحدة تحكّم المشرف في Google.
- انقر على رمز التطبيقات. تظهر صفحة "إدارة التطبيقات".
- انقر على Google Workspace. تظهر صفحة "إدارة تطبيقات Google Workspace".
- انتقِل إلى أسفل الصفحة وانقر على بحث السحابة الإلكترونية. تظهر صفحة "إعدادات Google Workspace" .
- انقر على تطبيقات البحث. تظهر صفحة "طلبات البحث".
- انقر على الرمز الأصفر المستدير +. سيظهر مربّع الحوار "إنشاء تطبيق بحث جديد".
- في حقل الاسم المعروض، أدخِل "tutorial".
- انقر على إنشاء.
- انقر على رمز القلم الرصاص بجانب تطبيق البحث الذي تم إنشاؤه حديثًا ("تعديل تطبيق البحث"). تظهر صفحة "تفاصيل طلب البحث".
- سجِّل رقم تعريف التطبيق.
- على يسار مصادر البيانات، انقر على رمز القلم الرصاص.
- بجانب "الدليل التعليمي"، انقر على مفتاح التبديل تفعيل. يؤدي تفعيل هذا الخيار إلى تفعيل مصدر بيانات البرنامج التعليمي لتطبيق البحث الذي تم إنشاؤه حديثًا.
- إلى يسار مصدر بيانات "الدليل التعليمي"، انقر على خيارات العرض.
- راجِع جميع السمات.
- انقر على حفظ.
- انقر على تم.
ضبط تطبيق الويب
بعد إنشاء بيانات الاعتماد وتطبيق البحث، عدِّل إعدادات التطبيق لتشمل هذه القيم على النحو التالي:
- من سطر الأوامر، غيِّر الدليل إلى `cloud-search-samples/end-to-end/search-interface/public.'
- افتح ملف
app.js
باستخدام محرِّر نصوص. - ابحث عن المتغيّر
searchConfig
في أعلى الملف. - استبدِل
[client-id]
بمعرِّف عميل OAuth الذي تم إنشاؤه سابقًا. - استبدِل
[application-id]
بمعرّف تطبيق البحث المُشار إليه في القسم السابق. - احفظ الملف.
تشغيل التطبيق
ابدأ التطبيق من خلال تنفيذ هذا الأمر:
npm run start
طلب البحث من الفهرس
لإجراء طلب بحث في الفهرس باستخدام التطبيق المصغّر للبحث:
- افتح المتصفّح وانتقِل إلى
http://localhost:8080
. - انقر على تسجيل الدخول لتفويض التطبيق بالبحث في Cloud Search نيابةً عنك.
- في مربّع البحث، أدخِل طلب بحث، مثل الكلمة "اختبار"، واضغط على مفتاح Enter. من المفترض أن تعرِض الصفحة نتائج طلب البحث مع الواجهات وعناصر التحكّم في ملف الصفحات للتنقّل في النتائج.
مراجعة الرمز
تتناول الأقسام المتبقية كيفية إنشاء واجهة المستخدم.
تحميل التطبيق المصغّر
يتم تحميل التطبيق المصغّر والمكتبات ذات الصلة في مرحلتين. أولاً، يتم تحميل ملف التمهيد البرمجي:
ثانيًا، يتمّ استدعاء دالة ردّ الاتصال onLoad
بعد أن يصبح النصّ البرمجي جاهزًا. بعد ذلك، يتم تحميل مكتبات
عميل Google API و"تسجيل الدخول باستخدام حساب Google" وتطبيقات Cloud Search المصغّرة.
وتتولى initializeApp
مهام الإعداد المتبقية للتطبيق بعد تحميل جميع المكتبات المطلوبة.
معالجة التفويض
على المستخدمين تفويض التطبيق بإجراء طلبات بحث نيابةً عنهم. على الرغم من أنّ التطبيق المصغّر يمكنه مطالبة المستخدمين بالموافقة، يمكنك توفير تجربة أفضل للمستخدمين من خلال معالجة عملية التفويض بنفسك.
بالنسبة إلى واجهة البحث، يعرض التطبيق طريقتَي عرض مختلفتَين استنادًا إلى حالة تسجيل دخول المستخدم.
أثناء الإعداد، يتم تفعيل طريقة العرض الصحيحة وضبط معالِجات أحداث تسجيل الدخول وتسجيل الخروج:
إنشاء واجهة البحث
يتطلب تطبيق "بحث Google" المصغّر قدرًا صغيرًا من ترميز HTML لطلب البحث وعرض نتائج البحث:
يتمّ إعداد التطبيق المصغّر وربطه بعنصرَي الإدخال والحاوية أثناء الإعداد:
تهانينا، لقد أكملت البرنامج التعليمي بنجاح. اتّبِع التعليمات التالية لتنظيف الجهاز.