ChannelSections

channelSection রিসোর্সে, চ্যানেলের ফিচার করার জন্য বেছে নেওয়া ভিডিওর একটি সেট সম্পর্কে তথ্য থাকে। যেমন, কোনও বিভাগে চ্যানেলের লেটেস্ট আপলোড, সবচেয়ে জনপ্রিয় আপলোড অথবা এক বা একাধিক প্লেলিস্টের ভিডিও ফিচার করা যেতে পারে।

একটি চ্যানেল সর্বাধিক ১০টি শেল্ফ তৈরি করতে পারে।

পদ্ধতি

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

তালিকা
API অনুরোধের মাপকাঠির সাথে মেলে এমন channelSection রিসোর্সের তালিকা দেখায়। এখনই ব্যবহার করে দেখুন।
ইনসার্ট করুন
যাচাই করা ব্যবহারকারীর চ্যানেলে একটি চ্যানেল বিভাগ যোগ করে। একটি চ্যানেল সর্বাধিক ১০টি শেল্ফ তৈরি করতে পারে। এখনই এটি ব্যবহার করে দেখুন।
আপডেট
চ্যানেল বিভাগ আপডেট করে। এখনই এটি ব্যবহার করে দেখুন।
মুছে দিন
চ্যানেল বিভাগ মুছে দেয়। এখনই এটি ব্যবহার করে দেখুন।

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

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

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

প্রপার্টি

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

প্রপার্টি
kind string
API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#channelSection।
etag etag
এই রিসোর্সের Etag.
id string
চ্যানেল বিভাগ অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।
snippet object
snippet অবজেক্টে চ্যানেল বিভাগের ধরন ও শীর্ষকের মতো প্রাথমিক বিবরণ থাকে।
snippet.type string
চ্যানেল বিভাগের ধরন।

এই প্রপার্টির জন্য সঠিক ভ্যালু হল:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
চ্যানেল বিভাগ প্রকাশ করেছে এমন চ্যানেলকে অনন্যভাবে শনাক্ত করতে YouTube যে আইডি ব্যবহার করে।
snippet.title string
বিভাগের নাম। আপনি শুধুমাত্র এমন চ্যানেল বিভাগের নাম সেট করতে পারবেন যার snippet.type ভ্যালু হয় multiplePlaylists অথবা multipleChannels এবং আসলে, এই ধরনের বিভাগ যোগ বা আপডেট করার সময় আপনাকে অবশ্যই নাম উল্লেখ করতে হবে। অন্য ধরনের চ্যানেল বিভাগের জন্য কোনও শীর্ষক উল্লেখ করলে, সেই মান উপেক্ষা করা হবে।

এই প্রপার্টির মানের সর্বাধিক দৈর্ঘ্য ১০০ অক্ষর এবং এতে < ও > ছাড়া সব সঠিক UTF-8 অক্ষর থাকতে পারে।
snippet.position unsigned integer
চ্যানেল পৃষ্ঠায় বিভাগের অবস্থান। এই প্রপার্টি ০-ভিত্তিক ইনডেক্স ব্যবহার করে। 0 ভ্যালু চ্যানেলে দেখানো প্রথম বিভাগকে চিহ্নিত করে, 1 ভ্যালু দ্বিতীয় বিভাগকে চিহ্নিত করে এবং এইভাবেই চলতে থাকে।

চ্যানেল বিভাগ যোগ করার সময় আপনি যদি এই প্রপার্টির জন্য কোনও ভ্যালু নির্দিষ্ট না করেন, তাহলে ডিফল্ট অ্যাকশন হিসেবে নতুন বিভাগটি শেষে দেখানো হয়।
contentDetails object
contentDetails অবজেক্টে চ্যানেল বিভাগের কন্টেন্ট সম্পর্কে বিবরণ থাকে, যেমন বিভাগে ফিচার করা প্লেলিস্ট বা চ্যানেলের তালিকা।
contentDetails.playlists[] list
চ্যানেল বিভাগে ফিচার করা এক বা একাধিক প্লেলিস্ট আইডির তালিকা। channelSection রিসোর্সের snippet.type প্রপার্টি singlePlaylist বা multiplePlaylists হলে, আপনাকে প্লেলিস্ট আইডির তালিকা উল্লেখ করতে হবে এবং এই প্রপার্টি অন্যান্য ধরনের বিভাগের জন্য উল্লেখ করা উচিত নয়। ধরনটি singlePlaylist হলে, এই তালিকায় অবশ্যই একটি প্লেলিস্ট আইডি উল্লেখ করতে হবে।
contentDetails.channels[] list
চ্যানেল বিভাগে ফিচার করা এক বা একাধিক চ্যানেল আইডির তালিকা। channelSection রিসোর্সের snippet.type প্রপার্টি multipleChannels হলে, আপনাকে অবশ্যই চ্যানেল আইডির একটি তালিকা উল্লেখ করতে হবে এবং এই প্রপার্টি অন্যান্য ধরনের বিভাগের জন্য উল্লেখ করা উচিত নয়। আপনি নিজের চ্যানেল তালিকায় অন্তর্ভুক্ত করতে পারবেন না।