Thumbnails: set

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

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

  • সর্বাধিক ফাইলের আকার: 2MB
  • গৃহীত মিডিয়া MIME প্রকার: image/jpeg , image/png , application/octet-stream

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

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

অনুরোধ

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