PlaylistItems

playlistItem রিসোর্স অন্য রিসোর্সকে শনাক্ত করে, যেমন প্লেলিস্টে অন্তর্ভুক্ত ভিডিও। এছাড়াও, playlistItem রিসোর্সে অন্তর্ভুক্ত রিসোর্স সম্পর্কে বিবরণ থাকে যা নির্দিষ্টভাবে সেই রিসোর্স সেই প্লেলিস্টে কীভাবে ব্যবহার করা হয় তার সাথে সম্পর্কিত।

এছাড়াও, YouTube আপলোড করা ভিডিওর তালিকা সহ একটি চ্যানেল শনাক্ত করতে প্লেলিস্ট ব্যবহার করে, সেই তালিকায় থাকা প্রতিটি playlistItem একটি আপলোড করা ভিডিওকে প্রতিনিধিত্ব করে। আপনি কোনও নির্দিষ্ট চ্যানেলের জন্য channel রিসোর্স থেকে সেই তালিকার প্লেলিস্ট আইডি পেতে পারেন। তারপরে, আপনি playlistItems.list পদ্ধতি ব্যবহার করে তালিকায় যোগ করতে পারবেন।

পদ্ধতি

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

তালিকা

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

যোগ করুন

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

আপডেট

প্লেলিস্ট আইটেম পরিবর্তন করে। যেমন, আপনি প্লেলিস্টে আইটেমের অবস্থান আপডেট করতে পারেন। এখনই এটি ব্যবহার করে দেখুন।

মুছে ফেলুন

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

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

নিচে দেওয়া JSON স্ট্রাকচার থেকে playlistItems রিসোর্সের ফর্ম্যাট সম্পর্কে জানা যায়:

{
  "kind": "youtube#playlistItem",
  "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,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

প্রপার্টি

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

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#playlistItem হবে।
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.videoOwnerChannelTitle	string যে চ্যানেল এই ভিডিও আপলোড করেছে সেই চ্যানেলের নাম।
snippet.videoOwnerChannelId	string যে চ্যানেল এই ভিডিও আপলোড করেছে সেটির চ্যানেল আইডি।
snippet.playlistId	string প্লেলিস্ট আইটেমটি যে প্লেলিস্টে আছে, সেটি অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।
snippet.position	unsigned integer প্লেলিস্টে আইটেমটি যে ক্রমে দেখানো হয়। এই ভ্যালু শূন্য-ভিত্তিক ইন্ডেক্স ব্যবহার করে, তাই প্রথম আইটেমের পজিশন হল 0, দ্বিতীয় আইটেমের পজিশন হল 1 এবং এইভাবে চলতে থাকে।
snippet.resourceId	object id অবজেক্টে এমন তথ্য থাকে যা প্লেলিস্ট আইটেম হিসেবে প্লেলিস্টে অন্তর্ভুক্ত রিসোর্সকে অনন্যভাবে শনাক্ত করতে ব্যবহার করা যেতে পারে।
snippet.resourceId.kind	string রেফার করা রিসোর্সের ধরন বা প্রকার।
snippet.resourceId.videoId	string snippet.resourceId.kind প্রপার্টির ভ্যালু youtube#video হলে, এই প্রপার্টি উপস্থিত থাকবে এবং এর ভ্যালুতে সেই আইডি থাকবে যা YouTube প্লেলিস্টে ভিডিওটিকে অনন্যভাবে শনাক্ত করতে ব্যবহার করে।
contentDetails	object অন্তর্ভুক্ত আইটেমটি YouTube ভিডিও হলে, contentDetails অবজেক্টটি রিসোর্সে অন্তর্ভুক্ত করা হয়। অবজেক্টে ভিডিও সম্পর্কে অতিরিক্ত তথ্য থাকে।
contentDetails.videoId	string YouTube ভিডিওকে অনন্যভাবে শনাক্ত করতে যে আইডি ব্যবহার করে। video রিসোর্স ফিরিয়ে আনতে, আপনার API অনুরোধে id কোয়েরি প্যারামিটারকে এই ভ্যালুতে সেট করুন।
contentDetails.startAt	string মনে রাখবেন: এই প্রপার্টি বাতিল করা হয়েছে এবং সেট করা থাকলে, এর ভ্যালু উপেক্ষা করা হয়। ভিডিও শুরু হওয়ার সময় থেকে সেকেন্ডে পরিমাপ করা সময়, যখন ভিডিও চালানো শুরু করা উচিত। (প্লেলিস্টের মালিক সেই সময় নির্দিষ্ট করতে পারেন যখন প্লেলিস্টের প্রসঙ্গে ভিডিওটি চালানো হলে সেটি শুরু ও বন্ধ করা উচিত।) ডিফল্ট মান হল 0।
contentDetails.endAt	string মনে রাখবেন: এই প্রপার্টি বাতিল করা হয়েছে এবং সেট করা থাকলে, এর ভ্যালু উপেক্ষা করা হয়। ভিডিও শুরু হওয়ার পর থেকে সেকেন্ডে পরিমাপ করা সময়, যখন ভিডিও চালানো বন্ধ করা উচিত। (প্লেলিস্টের মালিক প্লেলিস্টের প্রসঙ্গে ভিডিওটি চালানোর সময় ভিডিওটি কখন শুরু এবং বন্ধ করা উচিত তা নির্দিষ্ট করতে পারেন।) ডিফল্ট হিসেবে, ধরে নিন যে video.endTime হল ভিডিওর শেষ।
contentDetails.note	string এই আইটেমের জন্য ব্যবহারকারীর তৈরি করা নোট। প্রপার্টি ভ্যালুর সর্বাধিক দৈর্ঘ্য ২৮০টি অক্ষর।
contentDetails.videoPublishedAt	datetime YouTube-এ ভিডিও প্রকাশ করার তারিখ ও সময়। ভ্যালু ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে।
status	object status অবজেক্টে প্লেলিস্ট আইটেমের গোপনীয়তা স্ট্যাটাস সংক্রান্ত তথ্য থাকে।
status.privacyStatus	string প্লেলিস্ট আইটেমের গোপনীয়তা স্ট্যাটাস। যে চ্যানেলটি প্লেলিস্ট আইটেমটি প্রতিনিধিত্বকারী ভিডিও আপলোড করেছে, সেটি videos.insert বা videos.update পদ্ধতি ব্যবহার করে এই ভ্যালু সেট করতে পারে।