PlaylistItems

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

ইউটিউব একটি চ্যানেলের আপলোড করা ভিডিওর তালিকা শনাক্ত করতে একটি প্লেলিস্টও ব্যবহার করে, যেখানে সেই তালিকার প্রতিটি playlistItem একটি আপলোড করা ভিডিওকে প্রতিনিধিত্ব করে। আপনি একটি নির্দিষ্ট চ্যানেলের channel রিসোর্স থেকে সেই তালিকার প্লেলিস্ট আইডিটি পেতে পারেন। এরপর আপনি তালিকাটি অ্যাক্সেস করতে playlistItems.list মেথডটি ব্যবহার করতে পারেন।

পদ্ধতি

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

list

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

insert

প্লেলিস্টে একটি রিসোর্স যোগ করে। এখনই চেষ্টা করুন ।

update

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

delete

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

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

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