Thumbnails

thumbnail রিসোর্স, রিসোর্সের সাথে যুক্ত বিভিন্ন থাম্বনেল ছবির সাইজ শনাক্ত করে। থাম্বনেল ছবির নিম্নলিখিত বৈশিষ্ট্যগুলি মনে রাখবেন:

  • কোনও রিসোর্সের snippet.thumbnails প্রপার্টি হল এমন একটি অবজেক্ট যা সেই রিসোর্সের জন্য উপলভ্য থাম্বনেল ছবিকে শনাক্ত করে।
  • thumbnail রিসোর্সে অবজেক্টের একটি সিরিজ থাকে। প্রতিটি অবজেক্টের (default, medium, high ইত্যাদি) নাম থাম্বনেল ছবির সাইজকে বোঝায়।
  • বিভিন্ন ধরনের রিসোর্সে থাম্বনেল ছবির বিভিন্ন সাইজ কাজ করতে পারে।
  • বিভিন্ন ধরনের রিসোর্স একই নামের থাম্বনেল ছবির জন্য বিভিন্ন সাইজ নির্ধারণ করতে পারে। যেমন, video রিসোর্সের default থাম্বনেল ছবি সাধারণত ১২০x৯০ পিক্সেল হয় এবং channel রিসোর্সের default থাম্বনেল ছবি সাধারণত ৮৮x৮৮ পিক্সেল হয়।
  • একই ধরনের রিসোর্সের ক্ষেত্রেও, YouTube-এ আপলোড করা আসল ছবি বা কন্টেন্টের রেজোলিউশনের উপর নির্ভর করে নির্দিষ্ট কিছু ছবির থাম্বনেল ছবির সাইজ আলাদা হতে পারে। যেমন, HD ভিডিওতে নন-HD ভিডিওর তুলনায় বেশি রেজোলিউশনের থাম্বনেল ব্যবহার করা যেতে পারে।
  • থাম্বনেল ছবির সাইজ সম্পর্কে তথ্য আছে এমন প্রতিটি অবজেক্টে একটি width প্রপার্টি এবং একটি height প্রপার্টি থাকে। তবে, সেই ছবির জন্য প্রস্থ ও উচ্চতা প্রপার্টি নাও রিটার্ন করা হতে পারে।
  • আপলোড করা থাম্বনেল ছবির সাইজ প্রয়োজনীয় সাইজের সাথে ম্যাচ না করলে, ছবির অ্যাস্পেক্ট রেশিও পরিবর্তন না করেই সঠিক সাইজের সাথে ম্যাচ করার জন্য ছবির সাইজ পরিবর্তন করা হয়। ছবিটি ক্রপ করা হয়নি, তবে সাইজ সঠিক রাখার জন্য কালো বার যোগ করা হতে পারে।

পদ্ধতি

API-তে thumbnails রিসোর্সের জন্য নিম্নলিখিত পদ্ধতি কাজ করে:

সেট করুন
YouTube-এ কাস্টম ভিডিও থাম্বনেল আপলোড করে এবং কোনও ভিডিওর জন্য সেটি সেট করে।

রিসোর্স রিপ্রেজেন্টেশন

নিম্নলিখিত JSON স্ট্রাকচার thumbnails রিসোর্সের ফর্ম্যাট দেখায়:

{
  "default": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "medium": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "high": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "standard": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "maxres": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  }
}

প্রপার্টি

এই রিসোর্সে যেসব প্রপার্টি দেখা যায়, নিম্নলিখিত সারণীতে সেগুলি সম্পর্কে বলা হয়েছে:

প্রপার্টি
default object
ডিফল্ট থাম্বনেল ছবি। ভিডিওর ডিফল্ট থাম্বনেল – অথবা প্লেলিস্ট আইটেম বা সার্চ ফলাফলের মতো ভিডিওর রেফারেন্স দেয় এমন রিসোর্স – ১২০ পিক্সেল চওড়া এবং ৯০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের ডিফল্ট থাম্বনেল ৮৮ পিক্সেল চওড়া ও ৮৮ পিক্সেল লম্বা হয়।
default.url string
ছবির URL.
default.width unsigned integer
ছবির প্রস্থ।
default.height unsigned integer
ছবির উচ্চতা।
medium object
থাম্বনেল ছবির আরও বেশি রেজোলিউশন ভার্সন। কোনও ভিডিওর (বা ভিডিওর সাথে সম্পর্কিত রিসোর্স) ক্ষেত্রে, এই ছবি ৩২০ পিক্সেল চওড়া এবং ১৮০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের জন্য এই ছবিটি ২৪০ পিক্সেল চওড়া ও ২৪০ পিক্সেল লম্বা হয়।
medium.url string
ছবির URL.
medium.width unsigned integer
ছবির প্রস্থ।
medium.height unsigned integer
ছবির উচ্চতা।
high object
থাম্বনেল ছবির হাই রেজোলিউশন ভার্সন। ভিডিওর (বা ভিডিওর রেফারেন্স থাকা রিসোর্সের) ক্ষেত্রে, এই ছবির প্রস্থ ৪৮০ পিক্সেল এবং উচ্চতা ৩৬০ পিক্সেল। চ্যানেলের ক্ষেত্রে, এই ছবি ৮০০ পিক্সেল চওড়া ও ৮০০ পিক্সেল লম্বা হয়।
high.url string
ছবির URL.
high.width unsigned integer
ছবির প্রস্থ।
high.height unsigned integer
ছবির উচ্চতা।
standard object
high রেজোলিউশনের ছবির চেয়েও আরও বেশি রেজোলিউশনের থাম্বনেল ছবি। এই ছবি কিছু ভিডিও এবং ভিডিওর রেফারেন্স দেয় এমন অন্যান্য রিসোর্সের জন্য উপলভ্য, যেমন প্লেলিস্ট আইটেম বা সার্চ ফলাফল। এই ছবিটি ৬৪০ পিক্সেল চওড়া এবং ৪৮০ পিক্সেল লম্বা।
standard.url string
ছবির URL.
standard.width unsigned integer
ছবির প্রস্থ।
standard.height unsigned integer
ছবির উচ্চতা।
maxres object
থাম্বনেল ছবির সর্বোচ্চ রেজোলিউশন ভার্সন। এই ছবির সাইজ কিছু ভিডিও এবং ভিডিওর রেফারেন্স দেয় এমন অন্যান্য রিসোর্সের জন্য উপলভ্য, যেমন প্লেলিস্ট আইটেম বা সার্চ ফলাফল। এই ছবি ১২৮০ পিক্সেল চওড়া এবং ৭২০ পিক্সেল লম্বা।
maxres.url string
ছবির URL.
maxres.width unsigned integer
ছবির প্রস্থ।
maxres.height unsigned integer
ছবির উচ্চতা।