Thumbnails: set

YouTube-এ কাস্টম ভিডিও থাম্বনেল আপলোড করে এবং কোনও ভিডিওর জন্য সেটি সেট করে।

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

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

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

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

অনুরোধ করুন

HTTP অনুরোধ

POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set

অনুমোদন

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

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

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
videoId string
videoId প্যারামিটারটি এমন একটি YouTube ভিডিও আইডি নির্দিষ্ট করে যার জন্য কাস্টম ভিডিও থাম্বনেল প্রদান করা হচ্ছে।
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner string
মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে।

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

অনুরোধের বডি

অনুরোধের বডিতে আপনার আপলোড করা থাম্বনেল ছবি থাকে। অনুরোধের প্রধান অংশে thumbnail রিসোর্স নেই।

রেসপন্স

সফল হলে, এই পদ্ধতিটি নিম্নলিখিত গঠন সহ একটি রেসপন্স বডি রিটার্ন করে:

{
  "kind": "youtube#thumbnailSetResponse",
  "etag": etag,
  "items": [
    thumbnail resource
  ]
}

প্রপার্টি

নিম্নলিখিত সারণীতে এই রিসোর্সে দেখানো প্রপার্টিগুলি সংজ্ঞায়িত করা হয়েছে:

প্রপার্টি
kind string
API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#thumbnailSetResponse।
etag etag
এই রিসোর্সের Etag.
items[] list
থাম্বনেলের তালিকা।

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
badRequest (400) invalidImage প্রদান করা ছবির কন্টেন্ট সঠিক নয়।
badRequest (400) mediaBodyRequired অনুরোধে ইমেজ কন্টেন্ট অন্তর্ভুক্ত নেই।
forbidden (403) forbidden নির্দিষ্ট ভিডিওর জন্য থাম্বনেল সেট করা যাবে না। অনুরোধটি সঠিকভাবে অনুমোদিত নাও হতে পারে।
forbidden (403) forbidden যে ব্যবহারকারী যাচাই করেছেন তার কাস্টম ভিডিও থাম্বনেল আপলোড ও সেট করার অনুমতি নেই।
notFound (404) videoNotFound আপনি যে ভিডিওতে থাম্বনেল ছবি যোগ করতে চাইছেন সেটি খুঁজে পাওয়া যাচ্ছে না। অনুরোধের videoId প্যারামিটারের ভ্যালু সঠিক কিনা তা নিশ্চিত করুন।
tooManyRequests (429) uploadRateLimitExceeded চ্যানেলটি সম্প্রতি অনেক বেশি থাম্বনেল আপলোড করেছে। পরে আবার অনুরোধ করে দেখুন।

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

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