পদ্ধতি entities.search

সীমাবদ্ধতার সাথে মেলে এমন সত্তাগুলির জন্য জ্ঞানের গ্রাফ অনুসন্ধান করে।

HTTP অনুরোধ

GET https://kgsearch.googleapis.com/v1/entities:search

ক্যোয়ারী প্যারামিটার

পরামিতি নাম টাইপ বর্ণনা
query string নলেজ গ্রাফে অনুসন্ধান করার জন্য একটি আক্ষরিক স্ট্রিং।
ids string নলেজ গ্রাফে অনুসন্ধান করার জন্য সত্তা আইডিগুলির একটি তালিকা৷ HTTP অনুরোধে একাধিক আইডি নির্দিষ্ট করতে, URL-এ পরামিতিটি পুনরাবৃত্তি করুন যেমন ...?ids=A&ids=B
languages string কোয়েরি চালানোর জন্য ভাষা কোডের তালিকা (ISO 639-এ সংজ্ঞায়িত) যেমন `en`।
types string প্রত্যাবর্তিত সত্তাগুলিকে নির্দিষ্ট প্রকারের মধ্যে সীমাবদ্ধ করে। উদাহরণ স্বরূপ, আপনি `ব্যক্তি` নির্দিষ্ট করতে পারেন (যেমন http://schema.org/Person- এ সংজ্ঞায়িত করা হয়েছে) লোকেদের প্রতিনিধিত্বকারী সত্ত্বাগুলিতে ফলাফল সীমাবদ্ধ করতে। যদি একাধিক প্রকার নির্দিষ্ট করা থাকে, তবে প্রত্যাবর্তিত সত্তাগুলিতে এই ধরনের এক বা একাধিক থাকবে৷
indent boolean JSON ফলাফলের ইন্ডেন্টিং সক্ষম করে।
prefix boolean সত্তার নাম এবং উপনামের সাথে উপসর্গ (প্রাথমিক সাবস্ট্রিং) মিল সক্ষম করে৷ উদাহরণস্বরূপ, একটি উপসর্গ `Jung` সত্তা এবং উপনামের সাথে মিলবে যেমন `Jung`, `Jungle`, এবং `Jung-ho Kang`।
limit number ফেরত দেওয়া সত্তার সংখ্যা সীমিত করে। সর্বাধিক হল 500৷ ডিফল্ট হল 20৷ উচ্চ সীমা সহ অনুরোধগুলির সময় শেষ হওয়ার সম্ভাবনা বেশি৷

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

একটি প্রতিক্রিয়া বার্তায় সত্তার একটি তালিকা রয়েছে, যা JSON-LD ফর্ম্যাটে উপস্থাপিত এবং schema.org স্কিমাগুলির সাথে সামঞ্জস্যপূর্ণ (সীমিত বাহ্যিক এক্সটেনশন সহ)৷

নিম্নলিখিত JSON-LD উদাহরণটি দেখায় যে কীভাবে প্রতিক্রিয়া বডি গঠন করা হয়:

{
  "@context": {
    "@vocab": "http://schema.org/",
    "goog": "http://schema.googleapis.com/",
    "resultScore": "goog:resultScore",
    "detailedDescription": "goog:detailedDescription",
    "EntitySearchResult": "goog:EntitySearchResult",
    "kg": "http://g.co/kg"
  },
  "@type": "ItemList",
  "itemListElement": [
    {
      "@type": "EntitySearchResult",
      "result": {
        "@id": "kg:/m/0dl567",
        "name": "Taylor Swift",
        "@type": [
          "Thing",
          "Person"
        ],
        "description": "Singer-songwriter",
        "image": {
          "contentUrl": "https://t1.gstatic.com/images?q=tbn:ANd9GcQmVDAhjhWnN2OWys2ZMO3PGAhupp5tN2LwF_BJmiHgi19hf8Ku",
          "url": "https://en.wikipedia.org/wiki/Taylor_Swift",
          "license": "http://creativecommons.org/licenses/by-sa/2.0"
        },
        "detailedDescription": {
          "articleBody": "Taylor Alison Swift is an American singer-songwriter and actress. Raised in Wyomissing, Pennsylvania, she moved to Nashville, Tennessee, at the age of 14 to pursue a career in country music. ",
          "url": "http://en.wikipedia.org/wiki/Taylor_Swift",
          "license": "https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License"
        },
        "url": "http://taylorswift.com/"
      },
      "resultScore": 4850
    }
  ]
}

প্রতিক্রিয়া ক্ষেত্র

ক্ষেত্রের নাম টাইপ বর্ণনা
@id string সত্তার জন্য আদর্শ URI।
name string সত্তার নাম।
@type array সমর্থিত schema.org প্রকারের তালিকা যা সত্তার সাথে মেলে।
description string সত্তা একটি সংক্ষিপ্ত বিবরণ.
image URL সত্তা সনাক্ত করতে সাহায্য করার জন্য একটি চিত্র।
detailedDescription string সত্তার বিশদ বিবরণ।
url URL সত্তার অফিসিয়াল ওয়েবসাইট URL, যদি উপলব্ধ থাকে।
resultScore number সত্তা অনুরোধের সীমাবদ্ধতার সাথে কতটা ভালোভাবে মিলেছে তার একটি সূচক।

JSON-LD কীওয়ার্ড

JSON-LD কীওয়ার্ডের জন্য যেমন @context , @vocab , @type , বা @id , JSON-LD স্পেক পড়ুন।

Schema.org সামঞ্জস্য

প্রতিক্রিয়াটি schema.org- এ হোস্ট করা শব্দভান্ডার ব্যবহার করে, সীমিত এক্সটেনশন সহ (উদাহরণস্বরূপ, resultScore ) যা schema.org শব্দভান্ডারের সাথে সামঞ্জস্যপূর্ণ। এই এক্সটেনশনগুলি সম্পর্কে আরও বিস্তারিত জানার জন্য, স্কিমা এক্সটেনশনগুলির তালিকা দেখুন।

Schema.org প্রকারের প্রতিটির জন্য (যেমন Person ) এবং বৈশিষ্ট্যগুলির (যেমন name ) একটি সংশ্লিষ্ট পূর্ণ URI রয়েছে, যেমনটি নিম্নলিখিত উদাহরণগুলিতে রয়েছে:

  • ব্যক্তি -> http://schema.org/Person
  • জিনিস -> http://schema.org/Thing

  • নাম -> http://schema.org/name

  • বর্ণনা -> http://schema.org/description

Google স্কিমা এক্সটেনশন হিসাবে সংজ্ঞায়িত প্রকার এবং বৈশিষ্ট্যগুলিকে http://schema.googleapis.com দিয়ে প্রসারিত করা যেতে পারে। যেমন,

  • EntitySearchResult -> http://schema.googleapis.com/EntitySearchResult
  • বিস্তারিত বর্ণনা -> http://schema.googleapis.com/detailedDescription

প্রতিটি প্রকার এবং সম্পত্তির জন্য ডকুমেন্টেশন সংশ্লিষ্ট URI-তে পাওয়া যায়।

স্কিমা এক্সটেনশনের তালিকা

এই API-তে ব্যবহৃত স্কিমা এক্সটেনশনগুলি বাহ্যিক এক্সটেনশন হিসাবে http://schema.googleapis.com- এ হোস্ট করা হয়েছে।

Schema.org এর টাইপ এক্সটেনশন হল:

Schema.org এ সম্পত্তির এক্সটেনশনগুলি হল: