ChannelSections: update

চ্যানেল বিভাগ আপডেট করে।

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

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

অনুরোধ করুন

HTTP অনুরোধ

PUT 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 কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।

অনুরোধের বডি

অনুরোধের বডিতে 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) idInvalid id প্রপার্টিতে ভুল চ্যানেল বিভাগ আইডি উল্লেখ করা হয়েছে।
invalidValue (400) idRequired id প্রপার্টিতে অবশ্যই এমন একটি মান উল্লেখ করতে হবে যা আপডেট করা চ্যানেল বিভাগকে শনাক্ত করে।
invalidValue (400) inValidPosition snippet.position প্রপার্টিতে ভুল মান আছে।
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) channelSectionNotFound আপনি যে চ্যানেল বিভাগ আপডেট করার চেষ্টা করছেন সেটি খুঁজে পাওয়া যাচ্ছে না।
notFound (404) playlistNotFound নির্দিষ্ট করা এক বা একাধিক প্লেলিস্ট খুঁজে পাওয়া যায়নি।

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

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