LiveStreams: insert

একটি ভিডিও স্ট্রিম তৈরি করে। স্ট্রীমটি আপনাকে YouTube-এ আপনার ভিডিও পাঠাতে সক্ষম করে, যা আপনার দর্শকদের কাছে ভিডিওটি সম্প্রচার করতে পারে।

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

অনুরোধ

HTTP অনুরোধ

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

অনুমোদন

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

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

পরামিতি

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

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার এই অপারেশন দুটি উদ্দেশ্য পরিবেশন করে. এটি সেই বৈশিষ্ট্যগুলিকে চিহ্নিত করে যা লেখার ক্রিয়াকলাপ সেট করবে সেইসাথে API প্রতিক্রিয়াতে যে বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করা হবে।

প্যারামিটারের মানটিতে আপনি যে part বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে পারেন তা হল id , snippet , cdn , 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
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

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

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

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

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

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
insufficientPermissions insufficientLivePermissions অনুরোধটি নির্দিষ্ট লাইভ স্ট্রিম তৈরি করার জন্য অনুমোদিত নয়।
insufficientPermissions livePermissionBlocked অনুরোধটি অনুমোদনকারী ব্যবহারকারী এই সময়ে YouTube এ লাইভ ভিডিও স্ট্রিম করতে অক্ষম৷ ব্যবহারকারী কেন লাইভ ভিডিও স্ট্রিম করতে পারবেন না তা ব্যাখ্যা করে ব্যবহারকারীর চ্যানেল সেটিংস https://www.youtube.com/features- এ উপলব্ধ হতে পারে।
insufficientPermissions liveStreamingNotEnabled অনুরোধটি অনুমোদনকারী ব্যবহারকারী YouTube-এ লাইভ ভিডিও স্ট্রিম করতে সক্ষম নয়। ব্যবহারকারী https://www.youtube.com/features এ আরও তথ্য পেতে পারেন।
invalidValue (400) invalidDescription liveStream রিসোর্সে snippet.description প্রপার্টির মান 10000 অক্ষর পর্যন্ত থাকতে পারে।
invalidValue (400) invalidFormat liveStream রিসোর্সে cdn.format প্রপার্টির মান অবৈধ।
invalidValue (400) invalidFrameRate liveStream রিসোর্সে cdn.frameRate প্রপার্টির মান অবৈধ।
invalidValue (400) invalidIngestionType liveStream রিসোর্সে cdn.ingestionType প্রপার্টির মান অবৈধ।
invalidValue (400) invalidResolution liveStream রিসোর্সে cdn.resolution প্রপার্টির মান অবৈধ।
invalidValue (400) invalidTitle liveStream রিসোর্সে snippet.title প্রপার্টির মান অবশ্যই 1 থেকে 128 অক্ষরের মধ্যে হতে হবে।
rateLimitExceeded userRequestsExceedRateLimit ব্যবহারকারী একটি নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ পাঠিয়েছেন।
required (400) cdnRequired liveStream রিসোর্সে অবশ্যই cdn অবজেক্ট থাকতে হবে।
required (400) frameRateRequired যদি আপনি cdn.resolution প্রপার্টির জন্য একটি মান উল্লেখ করেন তবে cdn.frameRate প্রপার্টির জন্য না করলে API এই ত্রুটিটি ফেরত দেয়।
required (400) ingestionTypeRequired liveStream রিসোর্সকে অবশ্যই cdn.ingestionType প্রপার্টির জন্য একটি মান উল্লেখ করতে হবে।
required (400) resolutionRequired যদি আপনি cdn.frameRate প্রপার্টির জন্য একটি মান উল্লেখ করেন তবে cdn.resolution প্রপার্টির জন্য না করলে API এই ত্রুটিটি ফেরত দেয়।
required (400) titleRequired liveStream রিসোর্সকে অবশ্যই snippet.title প্রপার্টির জন্য একটি মান উল্লেখ করতে হবে।

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

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