جستجو کردن

جستجوی API دسترسی به داده‌های 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` ": لیست مرتب شده `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` ": از رتبه بندی طرحواره برای ویژگی ها و انواع استفاده کنید.
`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
}