PlaylistItems: insert

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

কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 50 ইউনিট।

সাধারণ ব্যবহারের ক্ষেত্রে

অনুরোধ

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 বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।

শরীরের অনুরোধ

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

  • এই বৈশিষ্ট্যগুলির জন্য আপনাকে অবশ্যই একটি মান নির্দিষ্ট করতে হবে:

    • snippet.playlistId
    • snippet.resourceId

  • আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:

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

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি প্লেলিস্ট আইটেম সংস্থান প্রদান করে।

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
forbidden (403) playlistContainsMaximumNumberOfVideos প্লেলিস্টে ইতিমধ্যেই সর্বাধিক অনুমোদিত সংখ্যক আইটেম রয়েছে৷
forbidden (403) playlistItemsNotAccessible অনুরোধটি নির্দিষ্ট প্লেলিস্ট আইটেম সন্নিবেশ করার জন্য সঠিকভাবে অনুমোদিত নয়।
invalidValue (400) invalidContentDetails অনুরোধে contentDetails সম্পত্তি বৈধ নয়। একটি সম্ভাব্য কারণ হল contentDetails.note ক্ষেত্রটি 280 অক্ষরের বেশি।
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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।