Search

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

পদ্ধতি

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

list

এপিআই অনুরোধে নির্দিষ্ট করা কোয়েরি প্যারামিটারের সাথে মেলে এমন সার্চ ফলাফলের একটি সংগ্রহ ফেরত দেয়। ডিফল্টরূপে, একটি সার্চ ফলাফল সেট মিলে যাওয়া 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 এপিআই রিসোর্সের ধরন শনাক্ত করে। এর মান হবে youtube#searchResult ।
etag	etag এই রিসোর্সের ই-ট্যাগ।
id	object id অবজেক্টটিতে এমন তথ্য থাকে যা সার্চ রিকোয়েস্টের সাথে মিলে যাওয়া রিসোর্সটিকে অনন্যভাবে শনাক্ত করতে ব্যবহার করা যেতে পারে।
id. kind	string এপিআই রিসোর্সের ধরণ।
id. videoId	string যদি id.type প্রপার্টির মান youtube#video হয়, তাহলে এই প্রপার্টিটি উপস্থিত থাকবে এবং এর মানে সেই আইডিটি থাকবে যা ইউটিউব সার্চ কোয়েরির সাথে মিলে যাওয়া একটি ভিডিওকে অনন্যভাবে শনাক্ত করতে ব্যবহার করে।
id. channelId	string যদি id.type প্রপার্টির ভ্যালু youtube#channel হয়, তাহলে এই প্রপার্টিটি উপস্থিত থাকবে এবং এর ভ্যালুতে সেই আইডিটি থাকবে যা ইউটিউব সার্চ কোয়েরির সাথে মিলে যাওয়া একটি চ্যানেলকে অনন্যভাবে শনাক্ত করতে ব্যবহার করে।
id. playlistId	string যদি id.type প্রপার্টির মান youtube#playlist হয়, তাহলে এই প্রপার্টিটি উপস্থিত থাকবে এবং এর মানে সেই আইডিটি থাকবে যা ইউটিউব সার্চ কোয়েরির সাথে মিলে যাওয়া একটি প্লেলিস্টকে অনন্যভাবে শনাক্ত করতে ব্যবহার করে।
snippet	object snippet অবজেক্টে একটি সার্চ রেজাল্টের প্রাথমিক বিবরণ থাকে, যেমন এর টাইটেল বা ডেসক্রিপশন। উদাহরণস্বরূপ, যদি সার্চ রেজাল্টটি একটি ভিডিও হয়, তাহলে টাইটেল হবে ভিডিওটির শিরোনাম এবং ডেসক্রিপশন হবে ভিডিওটির বিবরণ।
snippet. publishedAt	datetime অনুসন্ধানের ফলাফলে চিহ্নিত রিসোর্সটির তৈরির তারিখ ও সময়। মানটি ISO 8601 ফরম্যাটে নির্দিষ্ট করা হয়।
snippet. channelId	string যে মানটি ইউটিউব ব্যবহার করে সার্চ রেজাল্টে চিহ্নিত রিসোর্সটি প্রকাশকারী চ্যানেলকে অনন্যভাবে শনাক্ত করে।
snippet. title	string অনুসন্ধানের ফলাফলের শিরোনাম।
snippet. description	string অনুসন্ধানের ফলাফলের বিবরণ।
snippet. thumbnails	object অনুসন্ধানের ফলাফলের সাথে যুক্ত থাম্বনেইল ছবিগুলোর একটি ম্যাপ। ম্যাপের প্রতিটি অবজেক্টের ক্ষেত্রে, কী (key) হলো থাম্বনেইল ছবিটির নাম এবং ভ্যালু (value) হলো এমন একটি অবজেক্ট যা থাম্বনেইলটি সম্পর্কে অন্যান্য তথ্য ধারণ করে।
snippet.thumbnails. (key)	object বৈধ কী মানগুলি হলো: default – এটি হলো ডিফল্ট থাম্বনেইল ইমেজ। একটি ভিডিওর – অথবা ভিডিও সম্পর্কিত কোনো রিসোর্সের, যেমন প্লেলিস্ট আইটেম বা সার্চ রেজাল্টের – ডিফল্ট থাম্বনেইল হলো ১২০ পিক্সেল চওড়া এবং ৯০ পিক্সেল লম্বা। একটি চ্যানেলের ডিফল্ট থাম্বনেইল হলো ৮৮ পিক্সেল চওড়া এবং ৮৮ পিক্সেল লম্বা। medium – থাম্বনেইল ছবির একটি উচ্চতর রেজোলিউশনের সংস্করণ। একটি ভিডিওর (বা এমন কোনো রিসোর্সের যা একটি ভিডিওকে নির্দেশ করে) জন্য, এই ছবিটি ৩২০ পিক্সেল চওড়া এবং ১৮০ পিক্সেল লম্বা। একটি চ্যানেলের জন্য, এই ছবিটি ২৪০ পিক্সেল চওড়া এবং ২৪০ পিক্সেল লম্বা। high – থাম্বনেইল ইমেজটির একটি উচ্চ রেজোলিউশনের সংস্করণ। একটি ভিডিওর (বা এমন কোনো রিসোর্সের যা একটি ভিডিওকে নির্দেশ করে) জন্য, এই ইমেজটির প্রস্থ ৪৮০ পিক্সেল এবং উচ্চতা ৩৬০ পিক্সেল। একটি চ্যানেলের জন্য, এই ইমেজটির প্রস্থ ৮০০ পিক্সেল এবং উচ্চতা ৮০০ পিক্সেল। standard – high রেজোলিউশন ছবির চেয়েও উচ্চতর রেজোলিউশনের একটি থাম্বনেইল সংস্করণ। এই ছবিটি কিছু ভিডিও এবং ভিডিও-সম্পর্কিত অন্যান্য রিসোর্সের (যেমন প্লেলিস্ট আইটেম বা সার্চ রেজাল্ট) জন্য উপলব্ধ। এই ছবিটির প্রস্থ ৬৪০ পিক্সেল এবং উচ্চতা ৪৮০ পিক্সেল। maxres – থাম্বনেইল ইমেজের সর্বোচ্চ রেজোলিউশনের সংস্করণ। এই ইমেজ সাইজটি কিছু ভিডিও এবং ভিডিও-সম্পর্কিত অন্যান্য রিসোর্সের জন্য উপলব্ধ, যেমন প্লেলিস্ট আইটেম বা সার্চ রেজাল্ট। এই ইমেজটি ১২৮০ পিক্সেল চওড়া এবং ৭২০ পিক্সেল লম্বা। দ্রষ্টব্য: 1080p+ থাম্বনেইল ছবিগুলো ( fhd , qhd , এবং uhd ) সার্চ রেজাল্টের জন্য সমর্থিত নয়। উচ্চতর রেজোলিউশনের থাম্বনেইল পেতে, রিসোর্সটির আইডি ব্যবহার করে রিসোর্স-নির্দিষ্ট এন্ডপয়েন্ট (যেমন videos.list ) কল করুন।
snippet.thumbnails.(key). url	string ছবিটির ইউআরএল।
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 মানটি নির্দেশ করে যে চ্যানেলটিতে একটি সক্রিয় লাইভ সম্প্রচার রয়েছে।