بحث

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

طلب

طلب HTTP

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

المعلَمات

إنّ كل المعلّمات أدناه اختيارية، ولكن يجب أن يتوفّر لديك أحد الطلب أو الفلتر.

اسم المعلَمة	القيمة	الوصف
المعلّمات الاختيارية
`as_of_time`	`string`	قيمة MQL `as_of_time` للاستخدام مع طلبات البحث `mql_output`.
`callback`	`string`	اسم طريقة JS لاستدعاءات 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`": قائمة مرتبة من Freebase `ids`. "`mids`": قائمة مرتبة من Freebase `mids`.
`indent`	`boolean`	لتحديد ما إذا كنت تريد إضافة مسافة بادئة إلى نتائج JSON أم لا.
`lang`	`string`	رمز اللغة التي سيتم تنفيذ طلب البحث باستخدامها. الإعداد التلقائي هو 'en&#39؛
`limit`	`integer`	الحد الأقصى لعدد النتائج التي يمكن عرضها. بشكل تلقائي، يتم عرض 20 مطابقة بترتيب منخفض للصلة، إن وجدت. يمكن طلب عدد أقل أو أكثر من التطابقات باستخدام المعلمة `limit` بقيمة مختلفة. (مثال.)
`mql_output`	`string`	يعرض طلب البحث المؤهَّل لتشغيل النتائج استخراج المزيد من البيانات مرة أخرى. بعد تشغيل طلب البحث، يتم تمرير المستندات المطابقة&#39؛ إلى أرقام التعريف إلى طلب البحث MQL `mql_output` لاسترداد البيانات الفعلية عن التطابقات. يتم ترتيب نتائج MQL من خلال تقليل نتيجة مدى الصلة بموضوع البحث.
`prefixed`	`boolean`	مطابقة البادئة مقابل الأسماء والأسماء المستعارة.
`query`	`string`	عبارة طلب البحث عن
`scoring`	`string`	خوارزمية تقييم النتائج المطلوب استخدامها. القيم المقبولة هي: "`entity`": استخدِم ترتيبات Freebase والشهرة للكيان. (تلقائي) "`freebase`": استخدام ترتيب الكيانات Freebase. "`schema`": استخدِم ترتيب المخططات للمواقع والأنواع.
`spell`	`string`	الطلب 'هل تقصد' الاقتراحات القيم المقبولة هي: "`always`": اطلب اقتراحات إملائية لأي طلب بحث يبلغ طوله ثلاثة أحرف على الأقل. "`no_results`": طلب اقتراحات إملائية إذا لم يتم العثور على نتائج. "`no_spelling`": لا تطلب اقتراحات إملائية. (تلقائي)
`stemmed`	`boolean`	طلب بحث حول الأسماء المستعارة والأسماء المستعارة. لا يمكن استخدام البطاقة مع `prefixed`.
`type`	`string`	تقييد على المواضيع ذات معرف نوع Basebase.
`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
}