Playlists

playlist রিসোর্স YouTube প্লেলিস্টকে দেখায়। প্লেলিস্ট হল একাধিক ভিডিওর একটি সংগ্রহ যা ক্রমানুসারে দেখা এবং অন্যান্য ব্যবহারকারীর সাথে শেয়ার করা যায়। ডিফল্ট হিসেবে, প্লেলিস্ট অন্যান্য ব্যবহারকারীর কাছে সর্বজনীনভাবে দৃশ্যমান হয়, তবে প্লেলিস্ট সর্বজনীন বা ব্যক্তিগত হতে পারে।

এছাড়াও, YouTube কোনও চ্যানেলের ভিডিওর বিশেষ সংগ্রহ শনাক্ত করতে প্লেলিস্ট ব্যবহার করে, যেমন:

• আপলোড করা ভিডিও
• পজিটিভ রেটিং দেওয়া (লাইক করা) ভিডিও

আরও নির্দিষ্ট করে বলতে গেলে, এই তালিকাগুলি একটি চ্যানেলের সাথে যুক্ত, যা কোনও ব্যক্তি, গ্রুপ বা কোম্পানির ভিডিও, প্লেলিস্ট এবং অন্যান্য YouTube তথ্যের একটি সংগ্রহ। আপনি প্রদত্ত চ্যানেলের জন্য channel resource থেকে এইসব তালিকার প্রতিটির জন্য প্লেলিস্ট আইডি ফিরিয়ে আনতে পারবেন।

তারপর আপনি playlistItems.list পদ্ধতি ব্যবহার করে সেইসব তালিকার যেকোনও একটি ফিরিয়ে আনতে পারবেন। এছাড়াও, আপনি playlistItems.insert এবং playlistItems.delete পদ্ধতি কল করে সেইসব তালিকা থেকে আইটেম যোগ করতে বা সরাতে পারবেন।

পদ্ধতি

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

তালিকা

API অনুরোধের প্যারামিটারের সাথে মেলে এমন প্লেলিস্টের সংগ্রহ প্রদান করে। যেমন, আপনি যাচাই করা ব্যবহারকারীর মালিকানাধীন সব প্লেলিস্ট রিট্রিভ করতে পারেন অথবা অনন্য আইডি ব্যবহার করে এক বা একাধিক প্লেলিস্ট রিট্রিভ করতে পারেন। এখনই এটি ব্যবহার করে দেখুন।

ইনসার্ট করুন

একটি প্লেলিস্ট তৈরি করে। এখনই এটি ব্যবহার করে দেখুন।

আপডেট

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

মুছে ফেলুন

প্লেলিস্ট মুছে দেয়। এখনই এটি ব্যবহার করে দেখুন।

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

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

{
  "kind": "youtube#playlist",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string,
    "podcastStatus": enum
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

প্রপার্টি

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

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#playlist।
etag	etag এই রিসোর্সের Etag.
id	string 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 – থাম্বনেল ছবির হাই রেজোলিউশন ভার্সন। এই ছবির সাইজ কিছু ভিডিও এবং ভিডিওর রেফারেন্স দেয় এমন অন্যান্য রিসোর্সের জন্য উপলভ্য, যেমন প্লেলিস্ট আইটেম বা সার্চ ফলাফল। এই ছবিটি ১২৮০ পিক্সেল চওড়া এবং ৭২০ পিক্সেল লম্বা। fhd – থাম্বনেল ছবির ফুল হাই ডেফিনেশন (1080p) ভার্সন। এই ছবির সাইজ কিছু ভিডিওর জন্য উপলভ্য। এই ছবিটি ১৯২০ পিক্সেল চওড়া এবং ১০৮০ পিক্সেল লম্বা। qhd – থাম্বনেল ছবির কোয়াড হাই ডেফিনেশন (1440p / 2K) ভার্সন। এই ছবির সাইজ কিছু ভিডিওর জন্য উপলভ্য। এই ছবি ২৫৬০ পিক্সেল চওড়া এবং ১৪৪০ পিক্সেল লম্বা। uhd – থাম্বনেল ছবির আল্ট্রা-হাই রেজোলিউশন (4K) ভার্সন। এই ছবির সাইজ কিছু ভিডিওর জন্য উপলভ্য। এই ছবিটি ৩৮৪০ পিক্সেল চওড়া এবং ২১৬০ পিক্সেল লম্বা।
snippet.thumbnails.(key).url	string ছবির URL.
snippet.thumbnails.(key).width	unsigned integer ছবির প্রস্থ।
snippet.thumbnails.(key).height	unsigned integer ছবির উচ্চতা।
snippet.channelTitle	string ভিডিওটি যে চ্যানেলের অন্তর্গত, সেই চ্যানেলের নাম।
snippet.tags[]	list এই প্রপার্টি বন্ধ করা হয়েছে। প্লেলিস্টের সাথে যুক্ত কীওয়ার্ড ট্যাগ।
snippet.defaultLanguage	string playlist রিসোর্সের snippet.title এবং snippet.description প্রপার্টিতে টেক্সটের ভাষা।
snippet.localized	object snippet.localized অবজেক্টে প্লেলিস্টের জন্য কোনও স্থানীয় ভাষায় লেখা শীর্ষক ও বিবরণ অথবা প্লেলিস্টের মেটাডেটার জন্য ডিফল্ট ভাষায় লেখা শীর্ষক থাকে। playlists.list অনুরোধে যদি hl প্যারামিটার ব্যবহার করে এমন একটি ভাষা নির্দিষ্ট করা হয় যার জন্য লোকালাইজ করা টেক্সট রিটার্ন করতে হবে এবং সেই ভাষায় লোকালাইজ করা টেক্সট উপলভ্য থাকে, তাহলে রিসোর্স স্নিপেটে লোকালাইজ করা টেক্সট রিটার্ন করা হয়। hl প্যারামিটারের ভ্যালু নির্দিষ্ট করা না থাকলে অথবা ভ্যালু নির্দিষ্ট করা থাকলেও নির্দিষ্ট ভাষার জন্য লোকালাইজড মেটাডেটা উপলভ্য না থাকলে, ডিফল্ট ভাষার মেটাডেটা ফেরত দেওয়া হয়। প্রপার্টিতে কেবল পঠনযোগ্য ভ্যালু আছে। লোকালাইজ করা শীর্ষক যোগ, আপডেট বা মুছে দিতে localizations অবজেক্ট ব্যবহার করুন।
snippet.localized.title	string লোকালাইজ করা প্লেলিস্টের নাম।
snippet.localized.description	string স্থানীয় ভাষায় প্লেলিস্টের বিবরণ।
status	object status অবজেক্টে প্লেলিস্টের স্ট্যাটাস সংক্রান্ত তথ্য থাকে।
status.privacyStatus	string প্লেলিস্টের গোপনীয়তা স্ট্যাটাস। এই প্রপার্টির জন্য সঠিক ভ্যালু হল: private public unlisted
status.podcastStatus	string প্লেলিস্টের পডকাস্ট স্ট্যাটাস। ভ্যালু enabled হলে, প্লেলিস্টটি পডকাস্ট শো হিসেবে চিহ্নিত করা হয়। কোনও প্লেলিস্টের পডকাস্ট স্ট্যাটাস enabled হিসেবে সেট করতে, প্লেলিস্টে অবশ্যই প্লেলিস্টের ছবি থাকতে হবে। এই প্রপার্টির জন্য উপযুক্ত ভ্যালু হল: enabled disabled unspecified
contentDetails	object contentDetails অবজেক্টে প্লেলিস্টের কন্টেন্ট সম্পর্কে তথ্য থাকে, যার মধ্যে প্লেলিস্টে থাকা ভিডিওর সংখ্যাও অন্তর্ভুক্ত।
contentDetails.itemCount	unsigned integer প্লেলিস্টে থাকা ভিডিওর সংখ্যা।
player	object player অবজেক্টে এমন তথ্য থাকে যা আপনি এম্বেড করা প্লেয়ারে প্লেলিস্ট চালানোর জন্য ব্যবহার করবেন।
player.embedHtml	string <iframe> ট্যাগ যা এমন একটি প্লেয়ার এম্বেড করে যা প্লেলিস্ট চালাবে।
localizations	object localizations অবজেক্ট প্লেলিস্টের মেটাডেটার অনুবাদ এনক্যাপসুলেট করে।
localizations.(key)	object কী ভ্যালুর সাথে যুক্ত লোকালাইজ করা টেক্সটের ভাষা। মানটি হল একটি স্ট্রিং যাতে BCP-47 ভাষা কোড থাকে।
localizations.(key).title	string লোকালাইজ করা প্লেলিস্টের নাম।
localizations.(key).description	string স্থানীয় ভাষায় প্লেলিস্টের বিবরণ।