Watermarks: set

ইউটিউবে একটি ওয়াটারমার্ক ছবি আপলোড করে এবং চ্যানেলের জন্য তা সেট করে।

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

  • ফাইলের সর্বোচ্চ আকার: ১০ মেগাবাইট
  • অনুমোদিত মিডিয়া MIME টাইপসমূহ: image/jpeg , image/png , application/octet-stream

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

অনুরোধ

HTTP অনুরোধ 

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

অনুমোদন

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

পরিধি
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

প্যারামিটার

নিম্নলিখিত সারণিতে এই কোয়েরি দ্বারা সমর্থিত প্যারামিটারগুলো তালিকাভুক্ত করা হয়েছে। তালিকাভুক্ত সমস্ত প্যারামিটারই কোয়েরি প্যারামিটার।

প্যারামিটার
প্রয়োজনীয় প্যারামিটার
channelId string
channelId প্যারামিটারটি সেই ইউটিউব চ্যানেল আইডি নির্দিষ্ট করে, যার জন্য ওয়াটারমার্কটি প্রদান করা হচ্ছে।
ঐচ্ছিক পরামিতি
onBehalfOfContentOwner string
দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র ইউটিউব কন্টেন্ট পার্টনারদের জন্য উদ্দিষ্ট।

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

অনুরোধকারী শরীর

অনুরোধের মূল অংশে একটি watermark রিসোর্স প্রদান করুন। রিসোর্সটিতে নিম্নলিখিত প্রোপার্টিগুলো রয়েছে:

  • timing ( object , আবশ্যক): ওয়াটারমার্ক প্রদর্শনের সময়কে এনক্যাপসুলেট করে।
    • timing.type ( string , required): offsetFromStart অথবা offsetFromEnd যেকোনো একটিতে সেট করুন।
    • timing.offsetMs ( unsigned long , আবশ্যক): মিলিসেকেন্ডে শুরুর অফসেট। type offsetFromEnd হলে এটি অবশ্যই কমপক্ষে 1000 ms হতে হবে।
    • timing.durationMs ( unsigned long , ঐচ্ছিক): মিলিসেকেন্ডে দৃশ্যমান সময়কাল (সর্বনিম্ন 1000 মিলিসেকেন্ড)। যদি type offsetFromEnd হয়, তবে এটি অবশ্যই offsetMs অতিক্রম করবে না।
  • targetChannelId ( string , ঐচ্ছিক): ইউটিউব চ্যানেল আইডি, যেটিতে ওয়াটারমার্কটি লিঙ্ক করা থাকে। এটি বাদ দিলে, channelId দ্বারা চিহ্নিত চ্যানেলে লিঙ্ক হয়।
  • position ( object , deprecated): ইউটিউব এটি উপেক্ষা করে। ওয়াটারমার্ক সবসময় উপরের ডান কোণায় বসানো হয়।

প্রতিক্রিয়া

সফল হলে, এই মেথডটি একটি HTTP 204 No Content স্ট্যাটাস কোড রিটার্ন করে।

ত্রুটি

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

ত্রুটির ধরণ ত্রুটির বিবরণ বর্ণনা
badRequest (400) imageFormatUnsupported আপনি যে ছবিটি দিয়েছেন তা একটি অসমর্থিত ফরম্যাটে রয়েছে।
badRequest (400) imageTooTall আপনি যে ছবিটি দিয়েছেন তা অনেক লম্বা।
badRequest (400) imageTooWide আপনি যে ছবিটি দিয়েছেন তা অনেক বেশি চওড়া।
badRequest (400) mediaBodyRequired অনুরোধটিতে ছবির বিষয়বস্তু অন্তর্ভুক্ত নেই।
forbidden (403) forbidden নির্দিষ্ট চ্যানেলের জন্য ওয়াটারমার্ক সেট করা যাচ্ছে না। অনুরোধটি হয়তো যথাযথভাবে অনুমোদিত নয়, অথবা channelId প্যারামিটারটির মান অবৈধ।

চেষ্টা করে দেখুন!

এই এপিআই-টি কল করতে এবং এপিআই অনুরোধ ও প্রতিক্রিয়া দেখতে APIs Explorer ব্যবহার করুন।