PlaylistItems

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

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

পদ্ধতি

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

list
প্লেলিস্ট আইটেমগুলির একটি সংগ্রহ দেখায় যা API অনুরোধের পরামিতিগুলির সাথে মেলে৷ আপনি একটি নির্দিষ্ট প্লেলিস্টের সমস্ত প্লেলিস্ট আইটেম পুনরুদ্ধার করতে পারেন বা তাদের অনন্য আইডি দ্বারা এক বা একাধিক প্লেলিস্ট আইটেম পুনরুদ্ধার করতে পারেন৷ এখনই চেষ্টা করে দেখুন
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
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 - ডিফল্ট থাম্বনেইল চিত্র। একটি ভিডিওর জন্য ডিফল্ট থাম্বনেইল - বা একটি সংস্থান যা একটি ভিডিওকে বোঝায়, যেমন একটি প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল - 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. 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 হয়, তাহলে এই প্রপার্টিটি উপস্থিত থাকবে এবং এর মানটিতে এমন ID থাকবে যা YouTube প্লেলিস্টে ভিডিওটিকে অনন্যভাবে সনাক্ত করতে ব্যবহার করে।
contentDetails object
যদি অন্তর্ভুক্ত আইটেমটি একটি YouTube ভিডিও হয় তাহলে contentDetails বস্তুটি সম্পদে অন্তর্ভুক্ত করা হয়। বস্তুটিতে ভিডিও সম্পর্কে অতিরিক্ত তথ্য রয়েছে।
contentDetails. videoId string
ইউটিউব যে আইডিটি ব্যবহার করে একটি ভিডিওকে স্বতন্ত্রভাবে সনাক্ত করতে। video রিসোর্স পুনরুদ্ধার করতে, আপনার API অনুরোধে id ক্যোয়ারী প্যারামিটারটিকে এই মানটিতে সেট করুন।
contentDetails. startAt string
দ্রষ্টব্য: এই সম্পত্তি অবচয় করা হয়েছে এবং, সেট করা হলে, এর মান উপেক্ষা করা হয়।

সময়, ভিডিওর শুরু থেকে সেকেন্ডে পরিমাপ করা হয়, যখন ভিডিওটি চালানো শুরু হবে৷ (প্লেলিস্টের প্রেক্ষাপটে যখন ভিডিওটি প্লে করা হয় তখন প্লেলিস্টের মালিক ভিডিওটি কখন শুরু হবে এবং প্লে করা বন্ধ করার সময় নির্দিষ্ট করতে পারেন।) ডিফল্ট মান 0
contentDetails. endAt string
দ্রষ্টব্য: এই সম্পত্তি অবচয় করা হয়েছে এবং, সেট করা হলে, এর মান উপেক্ষা করা হয়।

সময়, ভিডিওর শুরু থেকে সেকেন্ডে পরিমাপ করা হয়, যখন ভিডিওটি চালানো বন্ধ করা উচিত। (প্লেলিস্টের প্রেক্ষাপটে যখন ভিডিওটি প্লে করা হয় তখন প্লেলিস্টের মালিক ভিডিওটি কখন শুরু হবে এবং চালানো বন্ধ করার সময় নির্দিষ্ট করতে পারেন।) ডিফল্টরূপে, ধরে নিন যে video.endTime হল ভিডিওটির শেষ।
contentDetails. note string
এই আইটেমটির জন্য একটি ব্যবহারকারী-উত্পাদিত নোট। সম্পত্তি মান সর্বোচ্চ 280 অক্ষর দৈর্ঘ্য আছে.
contentDetails. videoPublishedAt datetime
ভিডিওটি ইউটিউবে প্রকাশিত হওয়ার তারিখ এবং সময়। মানটি ISO 8601 বিন্যাসে নির্দিষ্ট করা হয়েছে।
status object
status অবজেক্টে প্লেলিস্ট আইটেমের গোপনীয়তা স্ট্যাটাস সম্পর্কে তথ্য থাকে।
status. privacyStatus string
প্লেলিস্ট আইটেমের গোপনীয়তার স্থিতি। যে চ্যানেলটি ভিডিও আপলোড করেছে যেটি প্লেলিস্ট আইটেমটি প্রতিনিধিত্ব করে তারা videos.insert বা videos.update পদ্ধতি ব্যবহার করে এই মান সেট করতে পারে৷
,

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

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

পদ্ধতি

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

list
প্লেলিস্ট আইটেমগুলির একটি সংগ্রহ দেখায় যা API অনুরোধের পরামিতিগুলির সাথে মেলে৷ আপনি একটি নির্দিষ্ট প্লেলিস্টের সমস্ত প্লেলিস্ট আইটেম পুনরুদ্ধার করতে পারেন বা তাদের অনন্য আইডি দ্বারা এক বা একাধিক প্লেলিস্ট আইটেম পুনরুদ্ধার করতে পারেন৷ এখনই চেষ্টা করে দেখুন
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
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 - ডিফল্ট থাম্বনেইল চিত্র। একটি ভিডিওর জন্য ডিফল্ট থাম্বনেইল - বা একটি সংস্থান যা একটি ভিডিওকে বোঝায়, যেমন একটি প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল - 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. 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 হয়, তাহলে এই প্রপার্টিটি উপস্থিত থাকবে এবং এর মানটিতে এমন ID থাকবে যা YouTube প্লেলিস্টে ভিডিওটিকে অনন্যভাবে সনাক্ত করতে ব্যবহার করে।
contentDetails object
যদি অন্তর্ভুক্ত আইটেমটি একটি YouTube ভিডিও হয় তাহলে contentDetails বস্তুটি সম্পদে অন্তর্ভুক্ত করা হয়। বস্তুটিতে ভিডিও সম্পর্কে অতিরিক্ত তথ্য রয়েছে।
contentDetails. videoId string
ইউটিউব যে আইডিটি ব্যবহার করে একটি ভিডিওকে স্বতন্ত্রভাবে সনাক্ত করতে। video রিসোর্স পুনরুদ্ধার করতে, আপনার API অনুরোধে id ক্যোয়ারী প্যারামিটারটিকে এই মানটিতে সেট করুন।
contentDetails. startAt string
দ্রষ্টব্য: এই সম্পত্তি অবচয় করা হয়েছে এবং, সেট করা হলে, এর মান উপেক্ষা করা হয়।

সময়, ভিডিওর শুরু থেকে সেকেন্ডে পরিমাপ করা হয়, যখন ভিডিওটি চালানো শুরু হবে৷ (প্লেলিস্টের প্রেক্ষাপটে যখন ভিডিওটি প্লে করা হয় তখন প্লেলিস্টের মালিক ভিডিওটি কখন শুরু হবে এবং প্লে করা বন্ধ করার সময় নির্দিষ্ট করতে পারেন।) ডিফল্ট মান 0
contentDetails. endAt string
দ্রষ্টব্য: এই সম্পত্তি অবচয় করা হয়েছে এবং, সেট করা হলে, এর মান উপেক্ষা করা হয়।

সময়, ভিডিওর শুরু থেকে সেকেন্ডে পরিমাপ করা হয়, যখন ভিডিওটি চালানো বন্ধ করা উচিত। (প্লেলিস্টের প্রেক্ষাপটে যখন ভিডিওটি প্লে করা হয় তখন প্লেলিস্টের মালিক ভিডিওটি কখন শুরু হবে এবং চালানো বন্ধ করার সময় নির্দিষ্ট করতে পারেন।) ডিফল্টরূপে, ধরে নিন যে video.endTime হল ভিডিওটির শেষ।
contentDetails. note string
এই আইটেমটির জন্য একটি ব্যবহারকারী-উত্পাদিত নোট। সম্পত্তি মান সর্বোচ্চ 280 অক্ষর দৈর্ঘ্য আছে.
contentDetails. videoPublishedAt datetime
ভিডিওটি ইউটিউবে প্রকাশিত হওয়ার তারিখ এবং সময়। মানটি ISO 8601 বিন্যাসে নির্দিষ্ট করা হয়েছে।
status object
status অবজেক্টে প্লেলিস্ট আইটেমের গোপনীয়তা স্ট্যাটাস সম্পর্কে তথ্য থাকে।
status. privacyStatus string
প্লেলিস্ট আইটেমের গোপনীয়তার স্থিতি। যে চ্যানেলটি ভিডিও আপলোড করেছে যেটি প্লেলিস্ট আইটেমটি প্রতিনিধিত্ব করে তারা videos.insert বা videos.update পদ্ধতি ব্যবহার করে এই মান সেট করতে পারে৷