تتيح لك واجهة 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 100 طلب بحث يوميًا مجانًا. إذا كنت بحاجة إلى المزيد، يمكنك الاشتراك في الفوترة في API Console. تبلغ تكلفة الطلبات الإضافية 5 دولارات أمريكية لكل 1,000 طلب بحث، وبحد أقصى 10,000 طلب بحث في اليوم.
التتبّع
تتوفّر إمكانية المراقبة الأساسية لواجهة Custom Search JSON API من خلال لوحة بيانات واجهة برمجة التطبيقات في Cloud Platform Console. للحصول على ميزات مراقبة أكثر تقدّمًا، تتوفّر حزمة عمليات 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.