একটি 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 | string id প্যারামিটারটি সম্প্রচারের অনন্য আইডি নির্দিষ্ট করে যা একটি ভিডিও স্ট্রিমের সাথে আবদ্ধ করা হচ্ছে। | |
part | string part প্যারামিটারটি এক বা একাধিক liveBroadcast রিসোর্স বৈশিষ্ট্যের একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে যা API প্রতিক্রিয়া অন্তর্ভুক্ত করবে। আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন যে part নাম হল id , snippet , contentDetails , এবং status । | |
ঐচ্ছিক পরামিতি | ||
onBehalfOfContentOwner | string এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷ onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের শংসাপত্রগুলি একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার মানতে নির্দিষ্ট সামগ্রীর মালিকের পক্ষে কাজ করছেন৷ এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি সামগ্রীর মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণ শংসাপত্র প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটাতে অ্যাক্সেস পেতে দেয়৷ ব্যবহারকারী যে CMS অ্যাকাউন্টের সাথে প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে। | |
onBehalfOfContentOwnerChannel | string এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷ onBehalfOfContentOwnerChannel প্যারামিটারটি যে চ্যানেলে একটি ভিডিও যোগ করা হচ্ছে তার YouTube চ্যানেল আইডি নির্দিষ্ট করে৷ এই প্যারামিটারটি প্রয়োজন হয় যখন একটি অনুরোধ onBehalfOfContentOwner প্যারামিটারের জন্য একটি মান নির্দিষ্ট করে এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, অনুরোধটি অবশ্যই একটি CMS অ্যাকাউন্ট ব্যবহার করে অনুমোদিত হতে হবে যা সামগ্রীর মালিকের সাথে লিঙ্কযুক্ত যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে৷ অবশেষে, onBehalfOfContentOwnerChannel প্যারামিটার মান যে চ্যানেলটি নির্দিষ্ট করে সেটি অবশ্যই সামগ্রীর মালিকের সাথে লিঙ্ক করতে হবে যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে।এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণের শংসাপত্র প্রদান না করেই বিষয়বস্তুর মালিকদের একবার প্রমাণীকরণ করতে এবং প্যারামিটার মানতে নির্দিষ্ট চ্যানেলের পক্ষে ক্রিয়া সম্পাদন করতে দেয়। | |
streamId | string streamId প্যারামিটার ভিডিও স্ট্রীমের অনন্য আইডি নির্দিষ্ট করে যা একটি সম্প্রচারে আবদ্ধ হচ্ছে। যদি এই প্যারামিটারটি বাদ দেওয়া হয়, তাহলে API সম্প্রচার এবং একটি ভিডিও স্ট্রিমের মধ্যে বিদ্যমান কোনো বাঁধাই সরিয়ে দেবে। |
শরীরের অনুরোধ
এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।
প্রতিক্রিয়া
সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি লাইভব্রডকাস্ট রিসোর্স ফেরত দেয়।
ত্রুটি
নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা 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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।