Custom Search JSON API

تتيح لك واجهة Custom Search JSON API تطوير مواقع إلكترونية وتطبيقات لاسترداد نتائج البحث من "محرك البحث المبرمَج" وعرضها آليًا. باستخدام واجهة برمجة التطبيقات هذه، يمكنك استخدام طلبات RESTful للحصول على نتائج بحث الويب أو البحث بالصور بتنسيق JSON.

تنسيق البيانات

يمكن لواجهة Custom Search JSON API عرض النتائج بتنسيق بيانات JSON.

تستخدم واجهة Custom Search JSON API مواصفات OpenSearch 1.1.

المتطلبات الأساسية

معرّف محرك البحث

قبل استخدام واجهة Custom Search JSON API، عليك أولاً إنشاء "محرك البحث المبرمَج" وضبطه. إذا لم يسبق لك إنشاء "محرك بحث مبرمج"، يمكنك البدء من خلال الانتقال إلى لوحة تحكّم "محرك البحث المبرمج".

اتّبِع البرنامج التعليمي لمعرفة المزيد عن خيارات الضبط المختلفة.

بعد إنشاء "محرك بحث مبرمَج"، انتقِل إلى مركز المساعدة لمعرفة كيفية العثور على معرّف محرك البحث.

مفتاح واجهة برمجة التطبيقات

تتطلّب واجهة Custom Search JSON API استخدام مفتاح واجهة برمجة التطبيقات.

الأسعار

تنطبق الأسعار التالية فقط على عملاء Custom Search JSON API الحاليين حتى تاريخ الإيقاف النهائي للخدمة في 1 يناير 2027. لا تتوفّر واجهة برمجة التطبيقات هذه للعملاء الجدد. توفّر واجهة Custom Search JSON API‏ 100 طلب بحث يوميًا مجانًا. وإذا كنت بحاجة إلى المزيد، يمكنك الاشتراك للحصول على الفوترة في وحدة تحكُّم واجهة برمجة التطبيقات. تبلغ تكلفة الطلبات الإضافية 5 دولار أمريكي لكل 1000 طلب بحث، بحد أقصى 10 آلاف طلب بحث في اليوم.

المراقبة

تتوفّر المراقبة الأساسية لواجهة Custom Search JSON API من خلال لوحة بيانات واجهة برمجة التطبيقات في وحدة تحكّم Cloud Platform. ولمراقبة أكثر تقدمًا، تتوفر حزمة عمليات Google Cloud (المعروفة سابقًا باسم Stackdriver).

باستخدام Google Cloud Operations، يمكنك إنشاء لوحات بيانات مخصّصة وإعداد التنبيهات والوصول إلى بيانات المقاييس آليًا. للوصول إلى بيانات استخدام Custom Search JSON API في Google Cloud Operations، اختَر "نوع المورد: واجهة برمجة التطبيقات المستخدَمة" (Resource type: Consumed API) وفلتِر حسب "الخدمة = 'customsearch.googleapis.com'" (service = 'customsearch.googleapis.com') في "أداة إنشاء الطلبات" (Query Builder).

يمكنك الاطّلاع على مراقبة استخدام واجهة برمجة التطبيقات لمناقشة إمكانات المراقبة والتنبيه المختلفة التي توفّرها لوحة بيانات واجهة برمجة التطبيقات ومجموعة Google Cloud Operations.