LiveBroadcasts: control

দ্রষ্টব্য: liveBroadcasts.control পদ্ধতিটি বাতিল করা হয়েছে এবং 1 অক্টোবর 2020-এ বা তার পরে কাজ করা বন্ধ করে দেবে। সেই তারিখের পরে, এই পদ্ধতিতে করা সমস্ত কল একটি নিষিদ্ধ (403) ত্রুটি ফিরিয়ে দেবে এবং পদ্ধতিটি পরে সম্পূর্ণরূপে সরানো হবে।

ক্লায়েন্টরা এখনও YouTube এর ইনজেশন সার্ভারে পাঠানো ভিডিওতে একটি ওভারলে যোগ করে তাদের নিজস্ব স্লেটিং বাস্তবায়ন করতে পারে। অবচয় ঘোষণা দেখুন ।

একটি স্লেটের সেটিংস নিয়ন্ত্রণ করে যা সম্প্রচার স্ট্রীমে প্রদর্শিত হতে পারে।

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

অনুরোধ

HTTP অনুরোধ

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

অনুমোদন

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

ব্যাপ্তি
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
id string
id প্যারামিটার YouTube লাইভ ব্রডকাস্ট আইডি নির্দিষ্ট করে যা স্লেট আপডেট করা সম্প্রচারকে অনন্যভাবে সনাক্ত করে।
part string
part প্যারামিটারটি এক বা একাধিক liveBroadcast রিসোর্স বৈশিষ্ট্যের একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে যা API প্রতিক্রিয়া অন্তর্ভুক্ত করবে। আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন যে part নাম হল id , snippet , contentDetails , এবং status ।
ঐচ্ছিক পরামিতি
displaySlate boolean
displaySlate প্যারামিটার নির্দিষ্ট করে যে স্লেটটি সক্ষম বা অক্ষম করা হচ্ছে।
offsetTimeMs unsigned long
offsetTimeMs প্যারামিটার একটি ইতিবাচক সময় অফসেট নির্দিষ্ট করে যখন নির্দিষ্ট স্লেট পরিবর্তন ঘটবে। মানটি সম্প্রচারের মনিটর স্ট্রীমের শুরু থেকে মিলিসেকেন্ডে পরিমাপ করা হয়, যে সময়টি সম্প্রচারের জন্য পরীক্ষার পর্যায় শুরু হয়েছিল। যদিও এটি মিলিসেকেন্ডে নির্দিষ্ট করা হয়েছে, মানটি আসলে একটি আনুমানিক, এবং YouTube সেই সময়ের মধ্যে যতটা সম্ভব কাছাকাছি থেকে অনুরোধ করা কাজটি সম্পূর্ণ করে।

আপনি যদি এই প্যারামিটারের জন্য একটি মান নির্দিষ্ট না করেন, তাহলে YouTube যত তাড়াতাড়ি সম্ভব কাজটি সম্পাদন করে। আরো বিস্তারিত জানার জন্য শুরু করার নির্দেশিকা দেখুন।

গুরুত্বপূর্ণ: আপনার সম্প্রচার স্ট্রীম বিলম্বিত হলে শুধুমাত্র এই প্যারামিটারের জন্য একটি মান নির্দিষ্ট করা উচিত।
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷

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

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

এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণের শংসাপত্র প্রদান না করেই বিষয়বস্তুর মালিকদের একবার প্রমাণীকরণ করতে এবং প্যারামিটার মানতে নির্দিষ্ট চ্যানেলের পক্ষে ক্রিয়া সম্পাদন করতে দেয়।
walltime datetime
walltime পরামিতি প্রাচীর ঘড়ির সময় নির্দিষ্ট করে যেখানে নির্দিষ্ট স্লেট পরিবর্তন ঘটবে। মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) ফর্ম্যাটে নির্দিষ্ট করা হয়েছে৷

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

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

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

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

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
backendError errorDisplaySlate অনুরোধ করা ক্রিয়া সম্পাদন করার সময় একটি ত্রুটি ঘটেছে৷
forbidden (403) liveBroadcastControlNotAllowed সম্প্রচারের স্ট্যাটাস live হলেই অনুরোধ করা পদক্ষেপের অনুমতি দেওয়া হয়।
insufficientPermissions insufficientLivePermissions ব্যবহারকারী অনুরোধকৃত অপারেশনের জন্য অনুমোদিত নয়, সম্ভবত কারণ ব্যবহারকারীর লাইভ স্ট্রিম করার অনুমতি নেই৷
insufficientPermissions liveStreamingNotEnabled অনুরোধটি অনুমোদনকারী ব্যবহারকারী YouTube-এ লাইভ ভিডিও স্ট্রিম করতে সক্ষম নয়। ব্যবহারকারী https://www.youtube.com/features এ আরও তথ্য পেতে পারেন।
invalidValue (400) conflictingTimeFields offsetTimeMs এবং walltime মধ্যে শুধুমাত্র একটি নির্দিষ্ট করা যেতে পারে।
invalidValue (400) invalidOffsetTimeMs offsetTimeMs প্যারামিটারের মানটি অবৈধ৷ প্যারামিটারের মান অবশ্যই ধনাত্মক হতে হবে, কিন্তু পরামিতি শুধুমাত্র তখনই নির্দিষ্ট করা যাবে যদি সম্প্রচারের মনিটর স্ট্রীম সক্ষম থাকে।
invalidValue (400) invalidWalltime walltime প্যারামিটারের মান অবৈধ৷
notFound (404) liveBroadcastNotFound id প্যারামিটার দ্বারা নির্দিষ্ট করা সম্প্রচারের অস্তিত্ব নেই৷
required (400) actionRequired API অনুরোধে অন্তত একটি ক্রিয়া নির্দিষ্ট করতে হবে৷ এই সময়ে, শুধুমাত্র সমর্থিত কর্ম হল স্লেট সক্ষম বা নিষ্ক্রিয় করার ক্ষমতা।
required (400) idRequired প্রয়োজনীয় id প্যারামিটারটি অবশ্যই আপডেট করা সম্প্রচার সনাক্ত করতে হবে।

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

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