Playlists

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

ইউটিউব একটি চ্যানেলের জন্য ভিডিওর বিশেষ সংগ্রহ চিহ্নিত করতেও প্লেলিস্ট ব্যবহার করে, যেমন:

• আপলোড করা ভিডিও
• ইতিবাচকভাবে রেট করা (পছন্দ করা) ভিডিও

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

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

পদ্ধতি

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

list

এপিআই অনুরোধের প্যারামিটারগুলোর সাথে মেলে এমন প্লেলিস্টগুলোর একটি সংগ্রহ ফেরত দেয়। উদাহরণস্বরূপ, আপনি প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত প্লেলিস্ট পুনরুদ্ধার করতে পারেন, অথবা তাদের অনন্য আইডি দ্বারা এক বা একাধিক প্লেলিস্ট পুনরুদ্ধার করতে পারেন। এখনই চেষ্টা করে দেখুন ।

insert

একটি প্লেলিস্ট তৈরি করে। এখনই চেষ্টা করুন ।

update

প্লেলিস্ট পরিবর্তন করে। উদাহরণস্বরূপ, আপনি একটি প্লেলিস্টের শিরোনাম, বিবরণ বা গোপনীয়তার অবস্থা পরিবর্তন করতে পারেন। এখনই চেষ্টা করুন ।

delete

প্লেলিস্ট মুছে ফেলে। এখনই চেষ্টা করুন ।

সম্পদ প্রতিনিধিত্ব

নিম্নলিখিত 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 এপিআই রিসোর্সের ধরন শনাক্ত করে। এর মান হবে youtube#playlist ।
etag	etag এই রিসোর্সের ই-ট্যাগ।
id	string যে আইডিটি ইউটিউব প্লেলিস্টটিকে স্বতন্ত্রভাবে শনাক্ত করতে ব্যবহার করে।
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 – থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশনের সংস্করণ। এই আকারের ছবিটি কিছু ভিডিও এবং ভিডিও-সম্পর্কিত অন্যান্য রিসোর্সের জন্য উপলব্ধ, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধানের ফলাফল। এই ছবিটির প্রস্থ ১২৮০ পিক্সেল এবং উচ্চতা ৭২০ পিক্সেল। fhd – থাম্বনেইল ছবির সম্পূর্ণ হাই ডেফিনিশন (1080p) সংস্করণ। এই আকারের ছবিটি কিছু ভিডিওর জন্য উপলব্ধ। এই ছবিটির প্রস্থ ১৯২০ পিক্সেল এবং উচ্চতা ১০৮০ পিক্সেল। qhd – থাম্বনেইল ইমেজের কোয়াড হাই ডেফিনিশন (1440p / 2K) সংস্করণ। এই ইমেজ সাইজটি কিছু ভিডিওর জন্য উপলব্ধ। এই ইমেজটি 2560px চওড়া এবং 1440px লম্বা। uhd – থাম্বনেইল ইমেজের আল্ট্রা-হাই রেজোলিউশন (4K) সংস্করণ। এই আকারের ইমেজটি কিছু ভিডিওর জন্য উপলব্ধ। এই ইমেজটি ৩৮৪০ পিক্সেল চওড়া এবং ২১৬০ পিক্সেল লম্বা।
snippet.thumbnails.(key). url	string ছবিটির ইউআরএল।
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 স্থানীয় প্লেলিস্টের বিবরণ।