LiveBroadcasts: transition

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

সাধারণ ব্যবহারের ক্ষেত্রে

অনুরোধ

HTTP অনুরোধ

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

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।

ব্যাপ্তি
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 প্যারামিটারের জন্য একটি মান নির্দিষ্ট করে এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, অনুরোধটি অবশ্যই একটি CMS অ্যাকাউন্ট ব্যবহার করে অনুমোদিত হতে হবে যা সামগ্রীর মালিকের সাথে লিঙ্কযুক্ত যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে৷ অবশেষে, onBehalfOfContentOwnerChannel প্যারামিটার মান যে চ্যানেলটি নির্দিষ্ট করে সেটি অবশ্যই সামগ্রীর মালিকের সাথে লিঙ্ক করতে হবে যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে।

এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণের শংসাপত্র প্রদান না করেই বিষয়বস্তুর মালিকদের একবার প্রমাণীকরণ করতে এবং প্যারামিটার মানতে নির্দিষ্ট চ্যানেলের পক্ষে ক্রিয়া সম্পাদন করতে দেয়।

শরীরের অনুরোধ

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

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

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি লাইভব্রডকাস্ট রিসোর্স ফেরত দেয়।

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

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

এটা চেষ্টা করুন!

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