Watermarks: set

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

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

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

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

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

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

সুযোগ
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 প্যারামিটারটি সেই YouTube চ্যানেল আইডি নির্দিষ্ট করে যার জন্য ওয়াটারমার্ক প্রদান করা হচ্ছে।
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner string
মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য।

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

অনুরোধের বডি

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

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

রেসপন্স

সফল হলে, এই পদ্ধতি একটি HTTP 204 No Content স্ট্যাটাস কোড রিটার্ন করে।

সমস্যা

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

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

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

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