ChannelBanners: insert

YouTube-এ চ্যানেল ব্যানার ছবি আপলোড করে। এই পদ্ধতিটি কোনও চ্যানেলের ব্যানার ছবি আপডেট করার জন্য তিনটি ধাপের প্রক্রিয়ার প্রথম দুটি ধাপকে উপস্থাপন করে:

  1. YouTube-এ বাইনারি ছবির ডেটা আপলোড করতে channelBanners.insert পদ্ধতি কল করুন। ছবির অ্যাস্পেক্ট রেশিও ১৬:৯ এবং সাইজ অন্তত ২০৪৮x১১৫২ পিক্সেল হতে হবে। আমরা ২৫৬০x১৪৪০ পিক্সেলের ছবি আপলোড করার সাজেশন দিই।
  2. ধাপ ১-এর জন্য API যে উত্তর দেয়, সেখান থেকে url প্রপার্টির ভ্যালু এক্সট্র্যাক্ট করুন।
  3. চ্যানেলের ব্র্যান্ডিং সেটিংস আপডেট করতে channels.update মেথড কল করুন। brandingSettings.image.bannerExternalUrl প্রপার্টির ভ্যালু ২ নম্বর ধাপে পাওয়া URL-এ সেট করুন।

এই পদ্ধতিতে মিডিয়া আপলোড করা যায়। আপলোড করা ফাইলকে অবশ্যই এইসব সীমাবদ্ধতা মেনে চলতে হবে:

  • ফাইলের সর্বাধিক সাইজ: ৬ এমবি
  • গ্রহণযোগ্য মিডিয়া MIME-এর ধরন: image/jpeg, image/png, application/octet-stream

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

অনুরোধ করুন

HTTP অনুরোধ

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

অনুমোদন

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

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

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

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

প্যারামিটারগুলি
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে।

মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে।

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

অনুরোধের বডি

এই পদ্ধতি কল করার সময় অনুরোধের বডি প্রদান করবেন না।

রেসপন্স

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

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
badRequest (400) bannerAlbumFull আপনার YouTube চ্যানেল আর্ট অ্যালবামে অনেক বেশি ছবি আছে। এটি ঠিক করতে, Google Photos-এ যান, তারপর অ্যালবাম পৃষ্ঠায় গিয়ে সেই অ্যালবাম থেকে কিছু ছবি সরিয়ে দিন।
badRequest (400) mediaBodyRequired অনুরোধে ইমেজ কন্টেন্ট অন্তর্ভুক্ত নেই।

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

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