البحث

تتيح واجهة برمجة تطبيقات البحث الوصول إلى بيانات Freebase عند تقديم طلب بحث بنص حر. يُرجى الرجوع إلى نظرة عامة على "بحث Google" وكتاب وصفات "بحث Google" للحصول على مزيد من المعلومات حول كيفية إنشاء طلبات بحث مفصّلة.

طلب

طلب HTTP

GET https://www.googleapis.com/freebase/v1/search

المعلمات

جميع المَعلمات أدناه اختيارية، ولكن يجب أن تتضمّن إحدى المَعلمتَين query أو filter.

اسم المعلَمة	القيمة	الوصف
المَعلمات الاختيارية
`as_of_time`	`string`	قيمة `as_of_time` للعميل المحتمل المؤهَّل للتسويق لاستخدامها مع طلبات البحث `mql_output`.
`callback`	`string`	اسم طريقة JavaScript لعمليات رد الاتصال JSONP.
`cursor`	`integer`	تتيح لك المَعلمة `cursor` مع المَعلمة `limit` تصفّح عدد محدّد من النتائج في كل مرة. على سبيل المثال، لعرض 3 صفحات من 10 نتائج متتالية، استخدِم `limit=10` و`cursor=0`، ثم `cursor=10` و`cursor=20`.
`domain`	`string`	يجب أن تكون المواضيع ضمن نطاق Freebase الذي يحمل هذا المعرّف.
`encode`	`string`	تمثّل هذه السمة ترميز الردّ. يمكنك استخدام هذه المَعلمة لتفعيل ترميز HTML. القيم المقبولة هي: ‫"`html`": لترميز أحرف معيّنة في الردّ (مثل العلامات وعلامات العطف) باستخدام ترميز HTML ‫"`off`": لا يتم ترميز الاستجابة. يجب عدم طباعة النتائج مباشرةً على صفحة ويب بدون إزالة أحرف HTML الخاصة من المحتوى أولاً. (تلقائي)
`exact`	`boolean`	طلب البحث عن الاسم والمفاتيح المطابقة فقط
`filter`	`string`	تسمح لك المَعلمة `filter` بإنشاء قواعد وقيود أكثر تعقيدًا لتطبيقها على طلب البحث. قيمة `filter` هي لغة بسيطة تتوافق مع الرموز التالية: عوامل التشغيل `all` و`any` و`should` و`not` المعاملات `type` و`domain` و`name` و`alias` و`with` و`without` الأقواس `(` و`)` للتجميع والأسبقية للتعرّف على كيفية استخدام السمة `filter`، يمكنك الاطّلاع على كتاب وصفات البحث.
`format`	`string`	التنسيق البنيوي لاستجابة JSON القيم المقبولة هي: "`entity`": معلومات أساسية حول الكيانات. (تلقائي) "`ids`": قائمة مرتبة من `ids` في Freebase. "`mids`": قائمة مرتبة من `mids` في Freebase.
`indent`	`boolean`	تحديد ما إذا كان سيتم ترك مسافة بادئة لنتائج JSON أم لا
`lang`	`string`	رمز اللغة التي سيتم تنفيذ طلب البحث بها. القيمة التلقائية هي "en".
`limit`	`integer`	تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. يتم تلقائيًا عرض 20 نتيجة مطابقة بترتيب تنازلي حسب الصلة بالموضوع، إذا كان هناك هذا العدد من النتائج. يمكن طلب عدد أقل أو أكثر من النتائج المطابقة باستخدام المَعلمة `limit` مع قيمة مختلفة. (مثال)
`mql_output`	`string`	استعلام MQL الذي سيتم تنفيذه مرة أخرى على النتائج لاستخراج المزيد من البيانات. بعد تنفيذ طلب البحث، يتم تمرير أرقام تعريف المستندات المطابقة إلى طلب بحث `mql_output` MQL لاسترداد البيانات الفعلية حول النتائج المطابقة. يتم ترتيب نتائج MQL حسب درجة الصلة بالموضوع تنازليًا.
`prefixed`	`boolean`	مطابقة البادئة مع الأسماء والأسماء المستعارة
`query`	`string`	عبارة طلب البحث المطلوب البحث عنها.
`scoring`	`string`	خوارزمية تسجيل مدى الصلة بالموضوع التي سيتم استخدامها القيم المقبولة هي: ‫"`entity`": استخدام Freebase وترتيب الكيانات حسب شعبيتها (تلقائي) ‫"`freebase`": استخدام ترتيب كيانات Freebase. "`schema`": استخدِم ترتيب schema للسمات والأنواع.
`spell`	`string`	طلب اقتراحات "هل تقصد" القيم المقبولة هي: "`always`": طلب اقتراحات تدقيق إملائي لأي طلب بحث يتضمّن ثلاثة أحرف على الأقل استبدِل `no_results` بـ: لطلب اقتراحات إملائية في حال لم يتم العثور على أي نتائج. "`no_spelling`": لا تطلب اقتراحات تدقيق إملائي. (تلقائي)
`stemmed`	`boolean`	طلب بحث عن الأسماء والأسماء المستعارة التي تم تقطيعها لا يمكن استخدامها مع `prefixed`.
`type`	`string`	يجب أن تكون المواضيع محصورة على تلك التي تتضمّن رقم التعريف الخاص بنوع Freebase هذا.
`with`	`string`	قاعدة فلتر للمطابقة.
`without`	`string`	قاعدة فلتر يجب عدم مطابقتها.

نص الطلب

لا تقدِّم نص طلب مع هذه الطريقة.

الردّ

إذا كانت الاستجابة ناجحة، ستكون عبارة عن بنية JSON.

{
  "status":"200 OK",
  "result":[
    {
      "mid":"/m/0b1zz",
      "name":"Nirvana",
      "notable":{"name":"Record Producer","id":"/music/producer"},
      "score":55.227268
    },{
      "mid":"/m/05b3c",
      "name":"Nirvana",
      "notable":{"name":"Belief","id":"/religion/belief"},
      "score":44.248726
    },{
      "mid":"/m/01h89tx",
      "name":"Nirvana",
      "notable":{"name":"Musical Album","id":"/music/album"},
      "score":30.371510
    },{
      "mid":"/m/01rn9fm",
      "name":"Nirvana",
      "notable":{"name":"Musical Group","id":"/music/musical_group"},
      "score":30.092449
    },{
      "mid":"/m/02_6qh",
      "name":"Nirvana",
      "notable":{"name":"Film","id":"/film/film"},
      "score":29.003593
    },{
      "mid":"/m/01rkx5",
      "name":"Nirvana Sutra",
      "score":21.344824
    }
  ],
  "cost":10,
  "hits":0
}