Search

একটি search ফলাফলে একটি YouTube ভিডিও, চ্যানেল বা প্লেলিস্ট সম্পর্কে তথ্য রয়েছে যা একটি API অনুরোধে নির্দিষ্ট করা অনুসন্ধান পরামিতিগুলির সাথে মেলে৷ যদিও একটি অনুসন্ধান ফলাফল একটি ভিডিওর মতো একটি অনন্যভাবে শনাক্তযোগ্য সম্পদের দিকে নির্দেশ করে, এটির নিজস্ব স্থায়ী ডেটা নেই৷

পদ্ধতি

API অনুসন্ধানের জন্য নিম্নলিখিত পদ্ধতিগুলিকে সমর্থন করে:

list
API অনুরোধে নির্দিষ্ট করা ক্যোয়ারী প্যারামিটারের সাথে মেলে এমন অনুসন্ধান ফলাফলের একটি সংগ্রহ দেখায়। ডিফল্টরূপে, একটি অনুসন্ধান ফলাফল সেট মিলিত video , channel এবং playlist সংস্থানগুলিকে চিহ্নিত করে, তবে আপনি শুধুমাত্র একটি নির্দিষ্ট ধরণের সংস্থান পুনরুদ্ধার করতে প্রশ্নগুলি কনফিগার করতে পারেন৷ এখনই চেষ্টা করে দেখুন ।

সম্পদ প্রতিনিধিত্ব

নিম্নলিখিত JSON গঠন একটি অনুসন্ধান ফলাফলের বিন্যাস দেখায়:

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

বৈশিষ্ট্য

নিম্নলিখিত সারণীটি অনুসন্ধান ফলাফলে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

বৈশিষ্ট্য
kind string
API সম্পদের ধরন সনাক্ত করে। মান হবে youtube#searchResult .
etag etag
এই সম্পদের Etag.
id object
id অবজেক্টে এমন তথ্য রয়েছে যা অনুসন্ধান অনুরোধের সাথে মেলে এমন সংস্থানটিকে অনন্যভাবে সনাক্ত করতে ব্যবহার করা যেতে পারে।
id. kind string
API সম্পদের ধরন।
id. videoId string
যদি id.type প্রপার্টির মান youtube#video হয়, তাহলে এই প্রপার্টিটি উপস্থিত থাকবে এবং এর মানটিতে এমন আইডি থাকবে যা ইউটিউব সার্চ কোয়েরির সাথে মেলে এমন একটি ভিডিওকে অনন্যভাবে সনাক্ত করতে ব্যবহার করে।
id. channelId string
যদি id.type প্রপার্টির মান youtube#channel হয়, তাহলে এই প্রপার্টিটি উপস্থিত থাকবে এবং এর মানটিতে এমন আইডি থাকবে যা ইউটিউব সার্চ কোয়েরির সাথে মেলে এমন একটি চ্যানেলকে অনন্যভাবে সনাক্ত করতে ব্যবহার করে।
id. playlistId string
যদি id.type প্রপার্টির মান youtube#playlist হয়, তাহলে এই প্রপার্টিটি উপস্থিত থাকবে এবং এর মানটিতে এমন ID থাকবে যা YouTube অনন্যভাবে একটি প্লেলিস্ট সনাক্ত করতে ব্যবহার করে যা সার্চ কোয়েরির সাথে মেলে।
snippet object
snippet অবজেক্টে একটি অনুসন্ধান ফলাফল সম্পর্কে প্রাথমিক বিবরণ রয়েছে, যেমন এর শিরোনাম বা বিবরণ। উদাহরণস্বরূপ, যদি অনুসন্ধানের ফলাফল একটি ভিডিও হয়, তাহলে শিরোনামটি হবে ভিডিওর শিরোনাম এবং বিবরণটি হবে ভিডিওর বিবরণ।
snippet. publishedAt datetime
রিসোর্স তৈরির তারিখ এবং সময় যা সার্চের ফলাফল শনাক্ত করে। মানটি ISO 8601 বিন্যাসে নির্দিষ্ট করা হয়েছে।
snippet. channelId string
ইউটিউব অনন্যভাবে সেই চ্যানেলটিকে সনাক্ত করতে ব্যবহার করে যেটি অনুসন্ধানের ফলাফল সনাক্ত করে এমন সংস্থান প্রকাশ করে।
snippet. title string
অনুসন্ধান ফলাফলের শিরোনাম।
snippet. description string
অনুসন্ধান ফলাফলের একটি বিবরণ.
snippet. thumbnails object
অনুসন্ধান ফলাফলের সাথে যুক্ত থাম্বনেইল চিত্রগুলির একটি মানচিত্র৷ মানচিত্রের প্রতিটি বস্তুর জন্য, কী হল থাম্বনেইল ছবির নাম, এবং মান হল একটি বস্তু যাতে থাম্বনেইল সম্পর্কে অন্যান্য তথ্য থাকে।
snippet.thumbnails. (key) object
বৈধ কী মান হল:
  • default - ডিফল্ট থাম্বনেইল চিত্র। একটি ভিডিওর জন্য ডিফল্ট থাম্বনেইল - বা একটি সংস্থান যা একটি ভিডিওকে বোঝায়, যেমন একটি প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল - 120px চওড়া এবং 90px লম্বা। একটি চ্যানেলের জন্য ডিফল্ট থাম্বনেইল 88px চওড়া এবং 88px লম্বা।
  • medium - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে বোঝায়), এই ছবিটি 320px চওড়া এবং 180px লম্বা। একটি চ্যানেলের জন্য, এই ছবিটি 240px চওড়া এবং 240px লম্বা৷
  • high - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে নির্দেশ করে), এই ছবিটি 480px চওড়া এবং 360px লম্বা। একটি চ্যানেলের জন্য, এই চিত্রটি 800px চওড়া এবং 800px লম্বা৷
  • standard - high রেজোলিউশনের ছবির চেয়ে থাম্বনেল ছবির একটি এমনকি উচ্চ রেজোলিউশন সংস্করণ। এই চিত্রটি কিছু ভিডিও এবং অন্যান্য সংস্থানগুলির জন্য উপলব্ধ যা ভিডিওগুলিকে উল্লেখ করে, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল৷ এই ছবিটি 640px চওড়া এবং 480px লম্বা৷
  • maxres - থাম্বনেইল ছবির সর্বোচ্চ রেজোলিউশন সংস্করণ। এই চিত্রের আকার কিছু ভিডিও এবং অন্যান্য সংস্থানগুলির জন্য উপলব্ধ যা ভিডিওগুলিকে উল্লেখ করে, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল৷ এই ছবিটি 1280px চওড়া এবং 720px লম্বা৷
snippet.thumbnails.(key). url string
ছবির URL.
snippet.thumbnails.(key). width unsigned integer
ছবিটির প্রস্থ।
snippet.thumbnails.(key). height unsigned integer
ছবিটির উচ্চতা।
snippet. channelTitle string
চ্যানেলের শিরোনাম যে সংস্থানটি প্রকাশ করেছে যা অনুসন্ধান ফলাফল সনাক্ত করে।
snippet. liveBroadcastContent string
একটি video বা channel সংস্থান লাইভ সম্প্রচার বিষয়বস্তু আছে কিনা একটি ইঙ্গিত. বৈধ সম্পত্তি মান upcoming , live , এবং none ।

একটি video সংস্থানের জন্য, upcoming একটি মান নির্দেশ করে যে ভিডিওটি একটি লাইভ সম্প্রচার যা এখনও শুরু হয়নি, যখন live একটি মান নির্দেশ করে যে ভিডিওটি একটি সক্রিয় লাইভ সম্প্রচার৷ channel রিসোর্সের জন্য, upcoming এর একটি মান নির্দেশ করে যে চ্যানেলের একটি নির্ধারিত সম্প্রচার রয়েছে যা এখনও শুরু হয়নি, যখন live একটি মান নির্দেশ করে যে চ্যানেলটির একটি সক্রিয় লাইভ সম্প্রচার রয়েছে।