PlaylistItems: insert

প্লেলিস্টে রিসোর্স যোগ করে।

কোটার উপর প্রভাব: এই পদ্ধতিতে কল করার জন্য ৫০ ইউনিট কোটা খরচ হয়।

সাধারণ ব্যবহারিক প্রয়োগ

অনুরোধ করুন

HTTP অনুরোধ

POST https://www.googleapis.com/youtube/v3/playlistItems

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদন প্রয়োজন (অনুমোদন ও যাচাইকরণ সম্পর্কে আরও জানুন)।

সুযোগ
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকায় থাকা সব প্যারামিটারই হল কোয়েরি প্যারামিটার।

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string এই অপারেশনে part প্যারামিটার দুটি উদ্দেশ্যে কাজ করে। এটি রাইট অপারেশন সেট করবে এমন প্রপার্টি এবং API রেসপন্সে অন্তর্ভুক্ত থাকবে এমন প্রপার্টি শনাক্ত করে। প্যারামিটারের মানে আপনি অন্তর্ভুক্ত করতে পারবেন এমন part-এর নাম নিম্নলিখিত তালিকায় রয়েছে: contentDetails id snippet status
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner	string এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য। onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিকদের একবার যাচাইকরণ করার এবং প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস করার অনুমতি দেয়। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাইকরণ করবেন সেটি অবশ্যই নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।

অনুরোধের বডি

অনুরোধের মূল অংশে একটি playlistItem রিসোর্স প্রদান করুন। সেই রিসোর্সের জন্য:

• এইসব প্রপার্টির জন্য আপনাকে অবশ্যই একটি মান উল্লেখ করতে হবে:

  • snippet.playlistId
  • snippet.resourceId

• আপনি এইসব প্রপার্টির জন্য ভ্যালু সেট করতে পারবেন:

  • snippet.playlistId
  • snippet.position
  • snippet.resourceId
  • contentDetails.note
  • contentDetails.startAt
  • contentDetails.endAt

রেসপন্স

সফল হলে, এই পদ্ধতিটি রেসপন্স বডিতে একটি playlistItem রিসোর্স রিটার্ন করে।

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ পাঠাতে পারে, তা নিম্নলিখিত টেবিলে শনাক্ত করা হয়েছে। আরও বিবরণের জন্য সমস্যার মেসেজ সংক্রান্ত ডকুমেন্টেশন দেখুন।

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
forbidden (403)	playlistContainsMaximumNumberOfVideos	প্লেলিস্টে সর্বাধিক যতগুলি আইটেম যোগ করা যায়, তা ইতিমধ্যেই যোগ করা হয়েছে।
forbidden (403)	playlistItemsNotAccessible	নির্দিষ্ট প্লেলিস্ট আইটেম যোগ করার জন্য অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
invalidValue (400)	invalidContentDetails	অনুরোধে contentDetails প্রপার্টি ভুল আছে। সম্ভাব্য কারণ হল, contentDetails.note ফিল্ড ২৮০ অক্ষরের চেয়ে বড়।
invalidValue (400)	invalidPlaylistItemPosition	অনুরোধটি প্লেলিস্ট আইটেমের অবস্থানকে একটি ভুল বা কাজ করে না এমন মান সেট করার চেষ্টা করে। রিসোর্সের snippet-এ position প্রপার্টির ভ্যালু চেক করুন।
invalidValue (400)	invalidResourceType	এই অপারেশনের জন্য রিসোর্স আইডির জন্য নির্দিষ্ট করা type কাজ করে না। রিসোর্স আইডি প্লেলিস্টে যোগ করা আইটেম শনাক্ত করে – যেমন youtube#video।
invalidValue (400)	manualSortRequired	অনুরোধটি প্লেলিস্ট আইটেমের পজিশন সেট করার চেষ্টা করে, কিন্তু প্লেলিস্টটি ম্যানুয়াল সর্টিং ব্যবহার করে না। (যেমন, প্লেলিস্টের আইটেম তারিখ বা জনপ্রিয়তার ভিত্তিতে সাজানো হতে পারে।) অনুরোধের মাধ্যমে যে রিসোর্স যোগ করা হচ্ছে সেখান থেকে snippet.position এলিমেন্ট সরিয়ে দিয়ে আপনি সমস্যার সমাধান করতে পারবেন। আপনি যদি চান যে প্লেলিস্ট আইটেমটি তালিকায় একটি নির্দিষ্ট অবস্থানে থাকুক, তাহলে আপনাকে প্রথমে প্লেলিস্টের সেটিংসে প্লেলিস্টের অর্ডার করা বিকল্পটি ম্যানুয়াল-এ আপডেট করতে হবে। YouTube ভিডিও ম্যানেজার থেকে এই সেটিংস অ্যাডজাস্ট করা যাবে।
invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	আপনি যে ভিডিওটি প্লেলিস্টে যোগ করার চেষ্টা করছেন সেটি আগে থেকেই অন্য সিরিজ প্লেলিস্টে রয়েছে।
notFound (404)	playlistNotFound	অনুরোধের playlistId প্যারামিটার দিয়ে শনাক্ত করা প্লেলিস্ট খুঁজে পাওয়া যায়নি।
notFound (404)	videoNotFound	আপনি যে ভিডিওটি প্লেলিস্টে যোগ করতে চাইছেন সেটি খুঁজে পাওয়া যাচ্ছে না। videoId প্রপার্টির ভ্যালু সঠিক কিনা তা নিশ্চিত করতে চেক করুন।
required (400)	channelIdRequired	অনুরোধে প্রয়োজনীয় channelId প্রপার্টির জন্য কোনও ভ্যালু উল্লেখ করা হয়নি।
required (400)	playlistIdRequired	অনুরোধে প্রয়োজনীয় playlistId প্রপার্টির জন্য কোনও ভ্যালু উল্লেখ করা হয়নি।
required (400)	resourceIdRequired	অনুরোধে অবশ্যই একটি রিসোর্স থাকতে হবে যেখানে snippet অবজেক্ট একটি resourceId নির্দিষ্ট করে।
invalidValue (400)	playlistOperationUnsupported	API-তে নির্দিষ্ট প্লেলিস্টে ভিডিও যোগ করার সুবিধা নেই। যেমন, আপনার আপলোড করা ভিডিওর প্লেলিস্টে কোনও ভিডিও যোগ করতে পারবেন না।

এটি ব্যবহার করে দেখুন!

এই API কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।