Playlists

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

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

  • আপলোড করা ভিডিও
  • ইতিবাচক রেট (পছন্দ) ভিডিও
আরও সুনির্দিষ্টভাবে বলতে গেলে, এই তালিকাগুলি একটি চ্যানেলের সাথে যুক্ত, যা একজন ব্যক্তি, গোষ্ঠী বা কোম্পানির ভিডিও, প্লেলিস্ট এবং অন্যান্য YouTube তথ্যের সংগ্রহ৷ আপনি একটি প্রদত্ত চ্যানেলের জন্য channel resource থেকে এই তালিকাগুলির প্রতিটির জন্য প্লেলিস্ট আইডি পুনরুদ্ধার করতে পারেন৷

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

পদ্ধতি

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

list
API অনুরোধের পরামিতিগুলির সাথে মেলে এমন প্লেলিস্টের একটি সংগ্রহ দেখায়। উদাহরণস্বরূপ, আপনি প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত প্লেলিস্ট পুনরুদ্ধার করতে পারেন, অথবা আপনি তাদের অনন্য আইডি দ্বারা এক বা একাধিক প্লেলিস্ট পুনরুদ্ধার করতে পারেন৷ এখনই চেষ্টা করে দেখুন
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
API সম্পদের ধরন সনাক্ত করে। মান হবে youtube#playlist .
etag etag
এই সম্পদের Etag.
id string
ইউটিউব যে আইডিটি ব্যবহার করে প্লেলিস্টকে অনন্যভাবে শনাক্ত করতে।
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 - ডিফল্ট থাম্বনেইল চিত্র। একটি ভিডিওর জন্য ডিফল্ট থাম্বনেইল - বা একটি সংস্থান যা একটি ভিডিওকে বোঝায়, যেমন একটি প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল - 120px চওড়া এবং 90px লম্বা। একটি চ্যানেলের জন্য ডিফল্ট থাম্বনেইল 88px চওড়া এবং 88px লম্বা।
  • medium - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে বোঝায়), এই ছবিটি 320px চওড়া এবং 180px লম্বা। একটি চ্যানেলের জন্য, এই ছবিটি 240px চওড়া এবং 240px লম্বা৷
  • high - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে নির্দেশ করে), এই ছবিটি 480px চওড়া এবং 360px লম্বা। একটি চ্যানেলের জন্য, এই চিত্রটি 800px চওড়া এবং 800px লম্বা৷
  • standard - high রেজোলিউশনের ছবির চেয়ে থাম্বনেল ছবির একটি এমনকি উচ্চ রেজোলিউশন সংস্করণ। এই চিত্রটি কিছু ভিডিও এবং অন্যান্য সংস্থানগুলির জন্য উপলব্ধ যা ভিডিওগুলিকে উল্লেখ করে, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল৷ এই ছবিটি 640px চওড়া এবং 480px লম্বা৷
  • maxres - থাম্বনেইল ছবির সর্বোচ্চ রেজোলিউশন সংস্করণ। এই চিত্রের আকার কিছু ভিডিও এবং অন্যান্য সংস্থানগুলির জন্য উপলব্ধ যা ভিডিওগুলিকে উল্লেখ করে, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল৷ এই ছবিটি 1280px চওড়া এবং 720px লম্বা৷
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
স্থানীয় প্লেলিস্টের বিবরণ।
,

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

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

  • আপলোড করা ভিডিও
  • ইতিবাচক রেট (পছন্দ) ভিডিও
আরও সুনির্দিষ্টভাবে বলতে গেলে, এই তালিকাগুলি একটি চ্যানেলের সাথে যুক্ত, যা একজন ব্যক্তি, গোষ্ঠী বা কোম্পানির ভিডিও, প্লেলিস্ট এবং অন্যান্য YouTube তথ্যের সংগ্রহ৷ আপনি একটি প্রদত্ত চ্যানেলের জন্য channel resource থেকে এই তালিকাগুলির প্রতিটির জন্য প্লেলিস্ট আইডি পুনরুদ্ধার করতে পারেন৷

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

পদ্ধতি

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

list
API অনুরোধের পরামিতিগুলির সাথে মেলে এমন প্লেলিস্টের একটি সংগ্রহ দেখায়। উদাহরণস্বরূপ, আপনি প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত প্লেলিস্ট পুনরুদ্ধার করতে পারেন, অথবা আপনি তাদের অনন্য আইডি দ্বারা এক বা একাধিক প্লেলিস্ট পুনরুদ্ধার করতে পারেন৷ এখনই চেষ্টা করে দেখুন
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
API সম্পদের ধরন সনাক্ত করে। মান হবে youtube#playlist .
etag etag
এই সম্পদের Etag.
id string
ইউটিউব যে আইডিটি ব্যবহার করে প্লেলিস্টকে অনন্যভাবে শনাক্ত করতে।
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 - ডিফল্ট থাম্বনেইল চিত্র। একটি ভিডিওর জন্য ডিফল্ট থাম্বনেইল - বা একটি সংস্থান যা একটি ভিডিওকে বোঝায়, যেমন একটি প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল - 120px চওড়া এবং 90px লম্বা। একটি চ্যানেলের জন্য ডিফল্ট থাম্বনেইল 88px চওড়া এবং 88px লম্বা।
  • medium - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে বোঝায়), এই ছবিটি 320px চওড়া এবং 180px লম্বা। একটি চ্যানেলের জন্য, এই ছবিটি 240px চওড়া এবং 240px লম্বা৷
  • high - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে নির্দেশ করে), এই ছবিটি 480px চওড়া এবং 360px লম্বা। একটি চ্যানেলের জন্য, এই চিত্রটি 800px চওড়া এবং 800px লম্বা৷
  • standard - high রেজোলিউশনের ছবির চেয়ে থাম্বনেল ছবির একটি এমনকি উচ্চ রেজোলিউশন সংস্করণ। এই চিত্রটি কিছু ভিডিও এবং অন্যান্য সংস্থানগুলির জন্য উপলব্ধ যা ভিডিওগুলিকে উল্লেখ করে, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল৷ এই ছবিটি 640px চওড়া এবং 480px লম্বা৷
  • maxres - থাম্বনেইল ছবির সর্বোচ্চ রেজোলিউশন সংস্করণ। এই চিত্রের আকার কিছু ভিডিও এবং অন্যান্য সংস্থানগুলির জন্য উপলব্ধ যা ভিডিওগুলিকে উল্লেখ করে, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল৷ এই ছবিটি 1280px চওড়া এবং 720px লম্বা৷
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
স্থানীয় প্লেলিস্টের বিবরণ।