ChannelSections: insert

অনুমোদিত ব্যবহারকারীর চ্যানেলে একটি চ্যানেল বিভাগ যোগ করে। কোনও চ্যানেল সর্বাধিক ১০টি শেল্ফ তৈরি করতে পারে।

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

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

অনুরোধ করুন

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 প্যারামিটারের জন্য কোনও ভ্যালু নির্দিষ্ট করা থাকলে এই প্যারামিটারটি প্রয়োজন এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্টের মালিকের সাথে লিঙ্ক করা CMS অ্যাকাউন্ট ব্যবহার করে অনুরোধটি অনুমোদিত হতে হবে। সবশেষে, onBehalfOfContentOwnerChannel প্যারামিটার ভ্যালু যে চ্যানেলকে নির্দিষ্ট করে, সেটি অবশ্যই onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে। এই প্যারামিটারটি সেইসব YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিককে একবার যাচাইকরণ করার এবং প্রতিটি আলাদা চ্যানেলের জন্য যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই প্যারামিটারের মানে নির্দিষ্ট করা চ্যানেলের হয়ে অ্যাকশন নেওয়ার অনুমতি দেয়।

অনুরোধের বডি

অনুরোধের বডিতে channelSection রিসোর্স প্রদান করুন। সেই রিসোর্সের জন্য:

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

  • snippet.type

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

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

রেসপন্স

সফল হলে, এই পদ্ধতি রেসপন্স বডিতে channelSection রিসোর্স ফিরিয়ে দেয়।

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে 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 কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।