Custom Search JSON API מאפשר לכם לפתח אתרים ואפליקציות כדי לאחזר ולהציג תוצאות חיפוש מ-Programmable Search Engine באופן פרוגרמטי. באמצעות ה-API הזה, אפשר להשתמש בבקשות RESTful כדי לקבל תוצאות של חיפוש באינטרנט או חיפוש תמונות בפורמט JSON.
פורמט נתונים
Custom Search JSON API יכול להחזיר תוצאות בפורמט נתונים של JSON.
מסמכים קשורים
Custom Search JSON API משתמש במפרט OpenSearch 1.1.
דרישות מוקדמות
מזהה מנוע החיפוש
לפני שמשתמשים ב-Custom Search JSON API, צריך קודם ליצור ולהגדיר את Programmable Search Engine. אם עדיין לא יצרתם Programmable Search Engine, תוכלו להתחיל בכניסה ללוח הבקרה של Programmable Search Engine.
במדריך מוסבר על אפשרויות ההגדרה השונות.
אחרי שיוצרים מנוע חיפוש באמצעות Programmable Search Engine, אפשר להיכנס למרכז העזרה כדי ללמוד איך למצוא את מזהה מנוע החיפוש.
מפתח API
כדי להשתמש ב-Custom Search JSON API, צריך להשתמש במפתח API.
תמחור
התמחור הבא רלוונטי רק ללקוחות קיימים של Custom Search JSON API עד להפסקת השירות ב-1 בינואר 2027. ה-API הזה לא זמין ללקוחות חדשים. Custom Search JSON API מספק 100 שאילתות חיפוש ביום בחינם. אם אתם צריכים יותר, אתם יכולים להירשם לחיוב במסוף לממשקי API. עלות בקשות נוספות היא 5 $לכל 1,000 שאילתות, עד 10,000 שאילתות ביום.
מעקב
אפשר לבצע ניטור בסיסי של Custom Search JSON API באמצעות מרכז הבקרה של ממשקי ה-API במסוף Cloud Platform. לצורך מעקב מתקדם יותר, אפשר להשתמש ב-Google Cloud's Operations Suite (לשעבר Stackdriver).
בעזרת Google Cloud Operations אפשר ליצור מרכזי בקרה בהתאמה אישית, להגדיר התראות ולגשת לנתוני מדדים באופן פרוגרמטי. כדי לגשת לנתוני השימוש ב-Custom Search JSON API ב-Google Cloud Operations, בוחרים באפשרות Resource type: Consumed API (סוג המשאב: API שנצרך) ומסננים לפי service = 'customsearch.googleapis.com' (שירות = 'customsearch.googleapis.com') ב-Query Builder (בונה השאילתות).
במאמר מעקב אחר השימוש ב-API מוסבר על יכולות המעקב וההתראות השונות שזמינות בלוח הבקרה של ה-API ובחבילת Google Cloud Operations.