LiveBroadcasts: insert

API এখন আপনার লাইভ সম্প্রচারগুলিকে "বাচ্চাদের জন্য তৈরি" হিসাবে চিহ্নিত করার ক্ষমতা সমর্থন করে এবং liveBroadcast সংস্থানটিতে এখন এমন একটি সম্পত্তি রয়েছে যা সেই লাইভ সম্প্রচারের "বাচ্চাদের জন্য তৈরি" স্থিতি সনাক্ত করে৷ YouTube API পরিষেবাগুলির পরিষেবার শর্তাবলী এবং বিকাশকারীর নীতিগুলিও 10 জানুয়ারী 2020-এ আপডেট করা হয়েছিল৷ আরও তথ্যের জন্য, অনুগ্রহ করে YouTube লাইভ স্ট্রিমিং API পরিষেবা এবং YouTube API পরিষেবাগুলির পরিষেবার শর্তাবলীর সংশোধনের ইতিহাসগুলি দেখুন৷

একটি সম্প্রচার তৈরি করে।

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

অনুরোধ

HTTP অনুরোধ

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

অনুমোদন

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

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

পরামিতি

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

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার এই অপারেশন দুটি উদ্দেশ্য পরিবেশন করে. এটি সেই বৈশিষ্ট্যগুলিকে চিহ্নিত করে যা লেখার ক্রিয়াকলাপ সেট করবে সেইসাথে 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 চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণের শংসাপত্র প্রদান না করেই বিষয়বস্তুর মালিকদের একবার প্রমাণীকরণ করতে এবং প্যারামিটার মানতে নির্দিষ্ট চ্যানেলের পক্ষে ক্রিয়া সম্পাদন করতে দেয়।

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

অনুরোধের অংশে একটি লাইভ ব্রডকাস্ট সংস্থান প্রদান করুন। সেই সম্পদের জন্য:

  • এই বৈশিষ্ট্যগুলির জন্য আপনাকে অবশ্যই একটি মান নির্দিষ্ট করতে হবে:

    • snippet.title
    • snippet.scheduledStartTime
    • status.privacyStatus

  • আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • status.selfDeclaredMadeForKids
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart

    দ্রষ্টব্য: সম্পত্তি টেবিলটি উপরে তালিকাভুক্ত বৈশিষ্ট্যগুলির জন্য সেট করা যেকোনো ডিফল্ট মানকে নথিভুক্ত করে। ডিফল্ট মান নিম্নলিখিত ক্ষেত্রে যেকোন একটিতে বরাদ্দ করা হবে:
    • আপনি সেই বৈশিষ্ট্যগুলির জন্য মান নির্দিষ্ট করবেন না।
    • আপনার অনুরোধে part প্যারামিটার মানটি সেই বৈশিষ্ট্যগুলি ধারণ করে এমন অংশ নির্দিষ্ট করে না।

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

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

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
insufficientPermissions insufficientLivePermissions অনুরোধ লাইভ সম্প্রচার তৈরি করার জন্য অনুমোদিত নয়.
insufficientPermissions livePermissionBlocked অনুরোধটি অনুমোদনকারী ব্যবহারকারী এই সময়ে YouTube এ লাইভ ভিডিও স্ট্রিম করতে অক্ষম৷ ব্যবহারকারী কেন লাইভ ভিডিও স্ট্রিম করতে পারবেন না তা ব্যাখ্যা করে ব্যবহারকারীর চ্যানেল সেটিংস https://www.youtube.com/features- এ উপলব্ধ হতে পারে।
insufficientPermissions liveStreamingNotEnabled অনুরোধটি অনুমোদনকারী ব্যবহারকারী YouTube-এ লাইভ ভিডিও স্ট্রিম করতে সক্ষম নয়। ব্যবহারকারী https://www.youtube.com/features এ আরও তথ্য পেতে পারেন।
invalidValue (400) invalidAutoStart লাইভব্রডকাস্ট রিসোর্সে contentDetails.enableAutoStart প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। সমস্ত সম্প্রচার এই সেটিং সমর্থন করে না৷
invalidValue (400) invalidAutoStop লাইভব্রডকাস্ট রিসোর্সে contentDetails.enableAutoStop প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। আপনি একটি অবিরাম সম্প্রচারের জন্য enableAutoStop সেটিং পরিবর্তন করতে পারবেন না৷
invalidValue (400) invalidDescription liveBroadcast সম্পদ snippet.description প্রপার্টির জন্য একটি বৈধ মান নির্দিষ্ট করেনি। সম্পত্তির মান 5000 অক্ষর পর্যন্ত থাকতে পারে।
invalidValue (400) invalidEmbedSetting লাইভব্রডকাস্ট রিসোর্সে contentDetails.enable_embed প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। আপনি এই সম্প্রচার এম্বেড করতে পারবেন না.
invalidValue (400) invalidLatencyPreferenceOptions লাইভব্রডকাস্ট রিসোর্সে contentDetails.latencyPreference প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। সমস্ত সেটিংস এই লেটেন্সি পছন্দের সাথে সমর্থিত নয়৷
invalidValue (400) invalidPrivacyStatus লাইভব্রডকাস্ট সংস্থানটিতে status.privacy_status সম্পত্তির জন্য একটি অবৈধ মান রয়েছে৷
invalidValue (400) invalidProjection লাইভব্রডকাস্ট রিসোর্সে contentDetails.projection প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। একটি ডিফল্ট সম্প্রচারের অভিক্ষেপ 360 এ সেট করা যাবে না৷
invalidValue (400) invalidScheduledEndTime লাইভব্রডকাস্ট সংস্থানটিতে snippet.scheduledEndTime সম্পত্তির জন্য একটি অবৈধ মান রয়েছে৷ নির্ধারিত শেষ সময় অবশ্যই নির্ধারিত শুরুর সময় অনুসরণ করবে।
invalidValue (400) invalidScheduledStartTime লাইভব্রডকাস্ট রিসোর্সে snippet.scheduledStartTime প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। নির্ধারিত শুরুর সময় অবশ্যই ভবিষ্যতে হতে হবে এবং বর্তমান তারিখের যথেষ্ট কাছাকাছি হতে হবে যাতে সেই সময়ে একটি সম্প্রচার নির্ভরযোগ্যভাবে নির্ধারিত হতে পারে।
invalidValue (400) invalidTitle liveBroadcast সম্পদ snippet.title প্রপার্টির জন্য একটি বৈধ মান নির্দিষ্ট করেনি। সম্পত্তির মান অবশ্যই 1 থেকে 100 অক্ষরের মধ্যে হতে হবে।
limitExceeded userBroadcastsExceedLimit ব্যবহারকারী অনেকগুলি লাইভ বা নির্ধারিত সম্প্রচার তৈরি করেছে এবং কিছু বন্ধ বা মুছে ফেলতে হবে৷
rateLimitExceeded userRequestsExceedRateLimit ব্যবহারকারী একটি নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ পাঠিয়েছেন।
required (400) privacyStatusRequired লাইভব্রডকাস্ট রিসোর্সকে অবশ্যই একটি গোপনীয়তার স্থিতি উল্লেখ করতে হবে। বৈধ privacyStatus মান দেখুন।
required (400) scheduledEndTimeRequired লাইভব্রডকাস্ট রিসোর্সকে অবশ্যই snippet.scheduledEndTime প্রপার্টি উল্লেখ করতে হবে।
required (400) scheduledStartTimeRequired লাইভব্রডকাস্ট রিসোর্সকে অবশ্যই snippet.scheduledStartTime প্রপার্টি উল্লেখ করতে হবে।
required (400) titleRequired লাইভব্রডকাস্ট রিসোর্সকে অবশ্যই snippet.title প্রপার্টি উল্লেখ করতে হবে।

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

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