LiveBroadcasts: insert

API এখন আপনার লাইভ ব্রডকাস্ট "বাচ্চাদের জন্য তৈরি করা" হিসেবে চিহ্নিত করার সুবিধা দেয় এবং liveBroadcast রিসোর্সে এখন একটি প্রপার্টি আছে যা সেই লাইভ ব্রডকাস্টের "বাচ্চাদের জন্য তৈরি করা" স্ট্যাটাস শনাক্ত করে। YouTube API পরিষেবার শর্তাবলী এবং ডেভেলপার নীতিও ১০ জানুয়ারি, ২০২০-এ আপডেট করা হয়েছে। আরও তথ্যের জন্য, YouTube Live Streaming 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 প্যারামিটারের জন্য কোনও ভ্যালু নির্দিষ্ট করা থাকলে এই প্যারামিটারটি প্রয়োজন এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্টের মালিকের সাথে লিঙ্ক করা CMS অ্যাকাউন্ট ব্যবহার করে অনুরোধটি অনুমোদিত হতে হবে। সবশেষে, onBehalfOfContentOwnerChannel প্যারামিটার ভ্যালু যে চ্যানেলকে নির্দিষ্ট করে, সেটি অবশ্যই onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে। এই প্যারামিটারটি সেইসব YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিককে একবার যাচাইকরণ করার এবং প্রতিটি আলাদা চ্যানেলের জন্য যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই প্যারামিটারের মানে নির্দিষ্ট করা চ্যানেলের হয়ে অ্যাকশন নেওয়ার অনুমতি দেয়।

অনুরোধের বডি

অনুরোধের মূল অংশে liveBroadcast রিসোর্স প্রদান করুন। সেই রিসোর্সের জন্য:

• এইসব প্রপার্টির জন্য আপনাকে অবশ্যই একটি মান উল্লেখ করতে হবে:

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

• আপনি এইসব প্রপার্টির জন্য ভ্যালু সেট করতে পারবেন:

  • snippet.title
  • snippet.description
  • snippet.categoryId
  • 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
  • contentDetails.availabilityConfig
  মনে রাখবেন: প্রপার্টি টেবিল তালিকাভুক্ত প্রপার্টির জন্য সেট করা যেকোনও ডিফল্ট ভ্যালু ডকুমেন্ট করে। নিম্নলিখিত যেকোনও ক্ষেত্রে ডিফল্ট মান অ্যাসাইন করা হবে:
  

  • আপনি এইসব প্রপার্টির জন্য ভ্যালু নির্দিষ্ট করেননি।
  • আপনার অনুরোধে part প্যারামিটারের মান সেই অংশটি নির্দিষ্ট করে না যাতে এই প্রপার্টিগুলি রয়েছে।

রেসপন্স

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

সমস্যা

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

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

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

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