একটি 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 বৈধ কী মান হল:
|
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 বৈধ কী মান হল:
|
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 পদ্ধতি ব্যবহার করে এই মান সেট করতে পারে৷ |