Search

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

পদ্ধতি

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

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

মনে রাখবেন: সার্চ ফলাফলের জন্য 1080p+ থাম্বনেল ছবি (fhd, qhd এবং uhd) কাজ করে না। আরও বেশি রেজোলিউশনের থাম্বনেল পেতে, রিসোর্সের আইডি ব্যবহার করে রিসোর্স-নির্দিষ্ট এন্ডপয়েন্ট (যেমন videos.list) কল করুন।
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 ভ্যালু নির্দেশ করে যে চ্যানেলে একটি অ্যাক্টিভ লাইভ ব্রডকাস্ট আছে।