ChannelSections: insert

প্রমাণীকৃত ব্যবহারকারীর চ্যানেলে একটি চ্যানেল বিভাগ যোগ করে। একটি চ্যানেল সর্বাধিক 10টি তাক তৈরি করতে পারে।

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

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

অনুরোধ

HTTP অনুরোধ

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

অনুমোদন

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

ব্যাপ্তি
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
ঐচ্ছিক পরামিতি
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷

onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের শংসাপত্রগুলি একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার মানতে নির্দিষ্ট সামগ্রীর মালিকের পক্ষে কাজ করছেন৷ এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি সামগ্রীর মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণ শংসাপত্র প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটাতে অ্যাক্সেস পেতে দেয়৷ ব্যবহারকারী যে CMS অ্যাকাউন্টের সাথে প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।
onBehalfOfContentOwnerChannel string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷

onBehalfOfContentOwnerChannel প্যারামিটারটি যে চ্যানেলে একটি ভিডিও যোগ করা হচ্ছে তার YouTube চ্যানেল আইডি নির্দিষ্ট করে৷ এই প্যারামিটারটি প্রয়োজন হয় যখন একটি অনুরোধ onBehalfOfContentOwner প্যারামিটারের জন্য একটি মান নির্দিষ্ট করে এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, অনুরোধটি অবশ্যই একটি CMS অ্যাকাউন্ট ব্যবহার করে অনুমোদিত হতে হবে যা সামগ্রীর মালিকের সাথে লিঙ্কযুক্ত যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে৷ অবশেষে, onBehalfOfContentOwnerChannel প্যারামিটার মান যে চ্যানেলটি নির্দিষ্ট করে সেটি অবশ্যই সামগ্রীর মালিকের সাথে লিঙ্ক করতে হবে যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে।

এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণের শংসাপত্র প্রদান না করেই বিষয়বস্তুর মালিকদের একবার প্রমাণীকরণ করতে এবং প্যারামিটার মানতে নির্দিষ্ট চ্যানেলের পক্ষে ক্রিয়া সম্পাদন করতে দেয়।

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

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

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

    • snippet.type

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

    • snippet.type
    • snippet.title
    • snippet.position
    • contentDetails.playlists[]
    • contentDetails.channels[]

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

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

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
badRequest (400) notEditable এই চ্যানেল বিভাগ তৈরি করা যাবে না.
badRequest (400) typeRequired channelSection রিসোর্স অবশ্যই snippet.type ক্ষেত্রের জন্য একটি মান নির্দিষ্ট করতে হবে।
forbidden (403) channelSectionForbidden অনুরোধটি সঠিকভাবে প্রমাণীকৃত নয় বা এই চ্যানেলের জন্য সমর্থিত নয়৷
invalidValue (400) channelNotActive নির্দিষ্ট চ্যানেলগুলির মধ্যে অন্তত একটি সক্রিয় নয়৷
invalidValue (400) channelsDuplicated অনুরোধ ব্যর্থ হয়েছে কারণ এটি ডুপ্লিকেট চ্যানেলগুলি নির্দিষ্ট করেছে৷
invalidValue (400) channelsNeeded যদি snippet.type প্রপার্টির multipleChannels মান থাকে, তাহলে contentDetails.channels[] প্রপার্টি অবশ্যই নির্দিষ্ট করতে হবে এবং অন্তত একটি চ্যানেল নির্দিষ্ট করতে হবে।
invalidValue (400) channelsNotExpected অনুরোধের সাথে প্রদত্ত সংস্থান contentDetails.channels[] বৈশিষ্ট্যের জন্য একটি মান নির্দিষ্ট করেছে, কিন্তু এই ধরনের চ্যানেল বিভাগের জন্য চ্যানেলগুলি প্রত্যাশিত নয়৷
invalidValue (400) contentDetailsNeeded আপনি যে সংস্থানটি সন্নিবেশ করছেন তা অবশ্যই এই ধরণের চ্যানেল বিভাগের জন্য একটি contentDetails অবজেক্ট থাকতে হবে৷
invalidValue (400) inValidPosition snippet.position বৈশিষ্ট্যে একটি অবৈধ মান রয়েছে৷
invalidValue (400) maxChannelSectionExceeded অনুরোধটি সম্পূর্ণ করা যাবে না কারণ চ্যানেলে ইতিমধ্যেই সর্বাধিক সংখ্যক চ্যানেল বিভাগ রয়েছে৷
invalidValue (400) maxChannelsExceeded অনুরোধটি ব্যর্থ হয়েছে কারণ এটি চ্যানেল বিভাগে অনেকগুলি চ্যানেল অন্তর্ভুক্ত করার চেষ্টা করেছে৷
invalidValue (400) maxPlaylistExceeded অনুরোধটি ব্যর্থ হয়েছে কারণ এটি চ্যানেল বিভাগে অনেকগুলি প্লেলিস্ট অন্তর্ভুক্ত করার চেষ্টা করেছে৷
invalidValue (400) onePlaylistNeeded snippet.type প্রপার্টির যদি singlePlaylist এর মান থাকে, তাহলে contentDetails.playlists[] প্রপার্টি অবশ্যই একটি প্লেলিস্ট নির্দিষ্ট করতে হবে।
invalidValue (400) ownChannelInChannels আপনি সেই চ্যানেলে প্রদর্শিত একটি চ্যানেল বিভাগে আপনার নিজের চ্যানেল অন্তর্ভুক্ত করতে পারবেন না।
invalidValue (400) playlistIsPrivate এক বা একাধিক নির্দিষ্ট প্লেলিস্ট ব্যক্তিগত এবং তাই চ্যানেল বিভাগে অন্তর্ভুক্ত করা যাবে না।
invalidValue (400) playlistsDuplicated অনুরোধ ব্যর্থ হয়েছে কারণ এটি ডুপ্লিকেট প্লেলিস্ট নির্দিষ্ট করেছে৷
invalidValue (400) playlistsNeeded snippet.type প্রপার্টির যদি singlePlaylist বা multiplePlaylists মান থাকে, তাহলে contentDetails.playlists[] প্রপার্টি অবশ্যই নির্দিষ্ট করতে হবে।
invalidValue (400) playlistsNotExpected অনুরোধের সাথে প্রদত্ত সংস্থান contentDetails.playlists[] সম্পত্তির জন্য একটি মান নির্দিষ্ট করেছে, কিন্তু এই ধরনের চ্যানেল বিভাগের জন্য প্লেলিস্টগুলি প্রত্যাশিত নয়৷
invalidValue (400) snippetNeeded চ্যানেল বিভাগ তৈরি করতে আপনাকে অবশ্যই একটি snippet নির্দিষ্ট করতে হবে।
invalidValue (400) titleLengthExceeded snippet.title প্রপার্টির মান অনেক বড়।
invalidValue (400) titleRequired যদি snippet.type প্রপার্টির multiplePlaylists বা multipleChannels মান থাকে, তাহলে আপনাকে অবশ্যই snippet.title প্রপার্টির জন্য একটি মান নির্দিষ্ট করে বিভাগের শিরোনাম সেট করতে হবে।
notFound (404) channelNotFound এক বা একাধিক নির্দিষ্ট চ্যানেল পাওয়া যাবে না।
notFound (404) playlistNotFound এক বা একাধিক নির্দিষ্ট প্লেলিস্ট পাওয়া যাবে না।

এটা চেষ্টা করুন!

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