LiveBroadcasts: transition

YouTube লাইভ ব্রডকাস্টের স্ট্যাটাস পরিবর্তন করে এবং নতুন স্ট্যাটাসের সাথে সম্পর্কিত যেকোনও প্রসেস শুরু করে। যেমন, আপনি কোনও ব্রডকাস্টের স্ট্যাটাস testing হিসেবে পরিবর্তন করলে, YouTube সেই ব্রডকাস্টের মনিটর স্ট্রিমে ভিডিও ট্রান্সমিট করা শুরু করে। এই পদ্ধতি কল করার আগে, আপনার ব্রডকাস্টের সাথে বাউন্ড করা স্ট্রিমের জন্য status.streamStatus প্রপার্টির ভ্যালু active কিনা তা কনফার্ম করতে হবে।

সাধারণ ব্যবহারিক প্রয়োগ

অনুরোধ করুন

HTTP অনুরোধ

POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition

অনুমোদন

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

সুযোগ
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকাবদ্ধ সব প্যারামিটার হল কোয়েরি প্যারামিটার।

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
broadcastStatus	string broadcastStatus প্যারামিটারটি সেই স্ট্যাটাস শনাক্ত করে যেটিতে ব্রডকাস্ট পরিবর্তন হচ্ছে। মনে রাখবেন, কোনও ব্রডকাস্টকে testing বা live স্টেটে ট্রানজিট করতে হলে, ব্রডকাস্ট যে স্ট্রিমের সাথে যুক্ত, তার status.streamStatus অবশ্যই active হতে হবে। গ্রহণযোগ্য ভ্যালু হল: complete – ব্রডকাস্ট শেষ হয়ে গেছে। YouTube ভিডিও ট্রান্সমিট করা বন্ধ করে দেয়। live – ব্রডকাস্টটি তার দর্শকদের কাছে দৃশ্যমান। YouTube, ব্রডকাস্টের মনিটর স্ট্রিম ও ব্রডকাস্ট স্ট্রিমে ভিডিও ট্রান্সমিট করে। testing – ব্রডকাস্ট পরীক্ষা করা শুরু করুন। YouTube ব্রডকাস্টের মনিটর স্ট্রিমে ভিডিও ট্রান্সমিট করে। মনে রাখবেন যে আপনি কোনও ব্রডকাস্টকে শুধুমাত্র testing অবস্থায় ট্রানজিশন করতে পারবেন যদি এর contentDetails.monitorStream.enableMonitorStream প্রপার্টি true-এ সেট করা থাকে।
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 প্যারামিটারের জন্য কোনও ভ্যালু নির্দিষ্ট করা থাকলে এই প্যারামিটারটি প্রয়োজন এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, onBehalfOfContentOwner প্যারামিটার যে কন্টেন্টের মালিককে নির্দিষ্ট করে, তার সাথে লিঙ্ক করা CMS অ্যাকাউন্ট ব্যবহার করে অনুরোধটি অবশ্যই অনুমোদিত হতে হবে। সবশেষে, onBehalfOfContentOwnerChannel প্যারামিটারের মান যে চ্যানেলকে নির্দিষ্ট করে, সেটি onBehalfOfContentOwner প্যারামিটারের নির্দিষ্ট করা কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং সেগুলি ম্যানেজ করেন। এটি কন্টেন্টের মালিককে একবার যাচাইকরণ করার এবং প্রতিটি আলাদা চ্যানেলের জন্য যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই প্যারামিটারের মানে নির্দিষ্ট করা চ্যানেলের হয়ে অ্যাকশন নেওয়ার অনুমতি দেয়।

অনুরোধের বডি

এই পদ্ধতি কল করার সময় অনুরোধের বডি প্রদান করবেন না।

রেসপন্স

সফল হলে, এই পদ্ধতি রেসপন্স বডিতে liveBroadcast রিসোর্স ফিরিয়ে দেয়।

সমস্যা

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

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
backendError	errorExecutingTransition	ব্রডকাস্টের স্ট্যাটাস পরিবর্তন করার সময় কোনও সমস্যা হয়েছে।
forbidden (403)	errorStreamInactive	ব্রডকাস্টের সাথে যুক্ত স্ট্রিম অ্যাক্টিভ না থাকলে, অনুরোধ করা ট্রানজিশন করা যাবে না।
forbidden (403)	invalidTransition	লাইভ সম্প্রচারটি তার বর্তমান স্ট্যাটাস থেকে অনুরোধ করা স্ট্যাটাসে পরিবর্তন করা যাবে না।
forbidden (403)	redundantTransition	লাইভ ব্রডকাস্টটি ইতিমধ্যেই অনুরোধ করা স্ট্যাটাসে রয়েছে বা অনুরোধ করা স্ট্যাটাসে প্রসেস করা হচ্ছে।
insufficientPermissions	insufficientLivePermissions	লাইভ ব্রডকাস্ট ট্রানজিশন করার জন্য অনুরোধটি অনুমোদিত নয়।
insufficientPermissions	livePermissionBlocked	যে ব্যবহারকারী অনুরোধ অনুমোদন করেছেন তিনি এই মুহূর্তে YouTube-এ লাইভ ভিডিও স্ট্রিম করতে পারছেন না। ব্যবহারকারী কেন লাইভ ভিডিও স্ট্রিম করতে পারছেন না সেই বিষয়ে বিস্তারিত জানতে, ফিচারের জন্য উপযুক্ততা বিকল্পে গিয়ে ব্যবহারকারীর চ্যানেল সেটিংস দেখুন।
insufficientPermissions	liveStreamingNotEnabled	যে ব্যবহারকারী অনুরোধ অনুমোদন করেছেন তিনি YouTube-এ লাইভ ভিডিও স্ট্রিম করার জন্য উপযুক্ত নন। আরও তথ্যের জন্য, ফিচারের উপযুক্ততা দেখুন।
notFound (404)	liveBroadcastNotFound	id প্যারামিটার দ্বারা নির্দিষ্ট করা ব্রডকাস্টের কোনও অস্তিত্ব নেই।
rateLimitExceeded (403)	userRequestsExceedRateLimit	ব্যবহারকারী নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ করেছেন।
rateLimitExceeded (403)	concurrentBroadcastsExceedLimit	চ্যানেলে ইতিমধ্যেই সর্বাধিক সংখ্যক কনকারেন্ট লাইভ ব্রডকাস্ট রয়েছে। চ্যানেলে অন্য একটি ব্রডকাস্ট শুরু করার আগে, আগে থেকেই লাইভ থাকা এক বা একাধিক ব্রডকাস্ট বন্ধ করতে হবে।
rateLimitExceeded (403)	sharedIngestionBroadcastsExceedLimit	চ্যানেলে ইতিমধ্যেই ইনজেশন সোর্স শেয়ার করা লাইভ ব্রডকাস্টের সর্বাধিক সংখ্যা রয়েছে। অনুরোধ করা ব্রডকাস্ট শুরু করতে, সেইসব ব্রডকাস্টের মধ্যে এক বা একাধিক ব্রডকাস্ট বন্ধ করতে হবে।
required (400)	idRequired	প্রয়োজনীয় id প্যারামিটারটি অবশ্যই সেই ব্রডকাস্টকে শনাক্ত করতে হবে যার স্ট্যাটাস আপনি পরিবর্তন করতে চান।
required (400)	statusRequired	API অনুরোধে অবশ্যই status প্যারামিটারের জন্য একটি মান উল্লেখ করতে হবে।

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

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