পদ্ধতি 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	সত্তা অনুরোধের সীমাবদ্ধতার সাথে কতটা ভালোভাবে মিলেছে তার একটি সূচক।

দ্রষ্টব্য: আপনি সঠিক সত্তা নির্বাচন করেছেন তা নিশ্চিত করতে আপনাকে সাহায্য করার জন্য ছবির URL প্রদান করা হয়েছে। Google API-এর মাধ্যমে আপনি প্রাপ্ত সমস্ত সামগ্রীর মতো, আপনার ছবিগুলির ব্যবহার প্রযোজ্য আইন মেনে চলছে তা নিশ্চিত করার জন্য আপনি দায়ী৷

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 এ সম্পত্তির এক্সটেনশনগুলি হল:

• বিস্তারিত বিবরণ
• ফলাফল স্কোর