কোনও স্ট্রিমে YouTube ব্রডকাস্ট বাইন্ড করে অথবা ব্রডকাস্ট ও স্ট্রিমের মধ্যে আগে থেকে থাকা বাইন্ডিং সরিয়ে দেয়। একটি ব্রডকাস্ট শুধুমাত্র একটি ভিডিও স্ট্রিমের সাথেই যুক্ত করা যায়, তবে একটি ভিডিও স্ট্রিম একাধিক ব্রডকাস্টের সাথে যুক্ত করা যেতে পারে।
সাধারণ ব্যবহারিক ক্ষেত্র
অনুরোধ করুন
HTTP অনুরোধ
POST https://www.googleapis.com/youtube/v3/liveBroadcasts/bind
অনুমোদন
এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদন প্রয়োজন (যাচাইকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন)।
| সুযোগ |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
প্যারামিটারগুলি
এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকাবদ্ধ সব প্যারামিটার হল কোয়েরি প্যারামিটার।
| প্যারামিটারগুলি | ||
|---|---|---|
| প্রয়োজনীয় প্যারামিটার | ||
id |
stringid প্যারামিটারটি ভিডিও স্ট্রিমের সাথে যুক্ত ব্রডকাস্টের অনন্য আইডি নির্দিষ্ট করে। |
|
part |
stringpart প্যারামিটারটি এক বা একাধিক liveBroadcast রিসোর্স প্রপার্টির কমা-সেপারেটেড তালিকা নির্দিষ্ট করে যা API উত্তর অন্তর্ভুক্ত করবে। প্যারামিটারের মানে আপনি যেসব part নাম যোগ করতে পারবেন সেগুলি হল id, snippet, contentDetails ও status। |
|
| ঐচ্ছিক প্যারামিটার | ||
onBehalfOfContentOwner |
stringএই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য। onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা বিভিন্ন YouTube চ্যানেল ম্যানেজ করেন। এটি কন্টেন্টের মালিকদের একবার যাচাইকরণ করার এবং প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস করার অনুমতি দেয়। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাইকরণ করবেন সেটি অবশ্যই নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে। |
|
onBehalfOfContentOwnerChannel |
stringএই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য। onBehalfOfContentOwnerChannel প্যারামিটারটি সেই চ্যানেলের YouTube চ্যানেল আইডি নির্দিষ্ট করে যেখানে ভিডিও যোগ করা হচ্ছে। কোনও অনুরোধে onBehalfOfContentOwner প্যারামিটারের জন্য কোনও ভ্যালু নির্দিষ্ট করা থাকলে এই প্যারামিটারটি প্রয়োজন এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্টের মালিকের সাথে লিঙ্ক করা CMS অ্যাকাউন্ট ব্যবহার করে অনুরোধটি অনুমোদিত হতে হবে। সবশেষে, onBehalfOfContentOwnerChannel প্যারামিটারের মান যে চ্যানেলকে নির্দিষ্ট করে, সেটি onBehalfOfContentOwner প্যারামিটারের নির্দিষ্ট করা কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে।এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং সেগুলি ম্যানেজ করেন। এটি কন্টেন্টের মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি আলাদা চ্যানেলের জন্য প্রমাণীকরণ ক্রেডেনশিয়াল প্রদান না করেই প্যারামিটার ভ্যালুতে নির্দিষ্ট করা চ্যানেলের হয়ে অ্যাকশন পারফর্ম করতে দেয়। |
|
streamId |
stringstreamId প্যারামিটারটি ব্রডকাস্টের সাথে যুক্ত ভিডিও স্ট্রিমের অনন্য আইডি নির্দিষ্ট করে। এই প্যারামিটার বাদ দেওয়া হলে, API ব্রডকাস্ট ও ভিডিও স্ট্রিমের মধ্যে আগে থেকে থাকা যেকোনও বাইন্ডিং সরিয়ে দেবে। |
|
অনুরোধের বডি
এই মেথড কল করার সময় কোনও অনুরোধ বডি প্রদান করবেন না।
রেসপন্স
সফল হলে, এই পদ্ধতি রেসপন্স বডিতে liveBroadcast রিসোর্স ফিরিয়ে দেয়।
সমস্যা
এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ পাঠাতে পারে, তা নিম্নলিখিত টেবিলে শনাক্ত করা হয়েছে। আরও বিবরণের জন্য সমস্যার মেসেজ সংক্রান্ত ডকুমেন্টেশন দেখুন।
| সমস্যার ধরন | সমস্যার বিবরণ | বিবরণ |
|---|---|---|
backendError |
internalError |
বাইন্ড করার সময় কোনও ইন্টার্নাল সমস্যা হয়েছে। |
forbidden (403) |
liveBroadcastBindingNotAllowed |
লাইভ ব্রডকাস্টের বর্তমান স্ট্যাটাস অনুযায়ী এটি কোনও স্ট্রিমে বাউন্ড করা যাবে না। |
insufficientPermissions |
insufficientLivePermissions |
নির্দিষ্ট লাইভ ব্রডকাস্ট ফিরিয়ে আনার জন্য অনুরোধটি অনুমোদিত নয়। আরও তথ্যের জন্য, OAuth2 যাচাইকরণ প্রয়োগ করা দেখুন। |
insufficientPermissions |
liveStreamingNotEnabled |
যে ব্যবহারকারী অনুরোধ অনুমোদন করেছেন, তিনি YouTube-এ লাইভ ভিডিও স্ট্রিম করার জন্য অনুমোদিত নন। ব্যবহারকারী https://www.youtube.com/features লিঙ্কে গিয়ে আরও তথ্য পেতে পারেন। |
notFound (404) |
liveBroadcastNotFound |
id প্যারামিটার দ্বারা নির্দিষ্ট করা ব্রডকাস্টের কোনও অস্তিত্ব নেই। |
notFound (404) |
liveStreamNotFound |
streamId প্যারামিটারের মাধ্যমে নির্দিষ্ট করা স্ট্রিমটি নেই। |
rateLimitExceeded |
userRequestsExceedRateLimit |
ব্যবহারকারী নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ করেছেন। |
required (400) |
idRequired |
বাধ্যতামূলক id প্যারামিটারকে অবশ্যই বাইন্ড করার জন্য ব্রডকাস্ট শনাক্ত করতে হবে। |
এটি ব্যবহার করে দেখুন!
এই API কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।