ইউটিউবে একটি চ্যানেল ব্যানার ইমেজ আপলোড করে। এই পদ্ধতিটি একটি চ্যানেলের জন্য ব্যানার ইমেজ আপডেট করার জন্য একটি তিন-পদক্ষেপ প্রক্রিয়ার প্রথম দুটি ধাপ উপস্থাপন করে:
- YouTube-এ বাইনারি ইমেজ ডেটা আপলোড করতে
channelBanners.insertপদ্ধতিতে কল করুন। ছবির একটি 16:9 অনুপাত থাকতে হবে এবং কমপক্ষে 2048x1152 পিক্সেল হতে হবে। আমরা একটি 2560px x 1440px চিত্র আপলোড করার পরামর্শ দিই। - পদক্ষেপ 1 এর জন্য API যে প্রতিক্রিয়া প্রদান করে তা থেকে
urlসম্পত্তির মান বের করুন। - চ্যানেলের ব্র্যান্ডিং সেটিংস আপডেট করতে
channels.updateপদ্ধতিতে কল করুন।brandingSettings.image.bannerExternalUrlপ্রপার্টির মান ধাপ 2 এ প্রাপ্ত URL-এ সেট করুন।
এই পদ্ধতি মিডিয়া আপলোড সমর্থন করে. আপলোড করা ফাইলগুলিকে অবশ্যই এই সীমাবদ্ধতাগুলি মেনে চলতে হবে:
- সর্বোচ্চ ফাইলের আকার: 6MB
- গৃহীত মিডিয়া MIME প্রকার:
image/jpeg,image/png,application/octet-stream
কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 50 ইউনিট।
অনুরোধ
HTTP অনুরোধ
POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert
অনুমোদন
এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।
| ব্যাপ্তি |
|---|
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 বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে। | |
শরীরের অনুরোধ
এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।
প্রতিক্রিয়া
সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি চ্যানেলব্যানার সংস্থান প্রদান করে।
ত্রুটি
নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.
| ত্রুটির ধরন | ত্রুটি বিস্তারিত | বর্ণনা |
|---|---|---|
badRequest (400) | bannerAlbumFull | আপনার YouTube চ্যানেল আর্ট অ্যালবামে অনেকগুলি ছবি রয়েছে৷ দয়া করে http://photos.google.com- এ যান, অ্যালবাম পৃষ্ঠায় নেভিগেট করুন এবং সেই অ্যালবাম থেকে কিছু ছবি সরিয়ে দিন। |
badRequest (400) | mediaBodyRequired | অনুরোধে ছবির বিষয়বস্তু অন্তর্ভুক্ত নয়। |
এটা চেষ্টা করুন!
এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।