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

অনুরোধের বডি

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

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

  • snippet.title
  • cdn.frameRate
  • cdn.ingestionType
  • cdn.resolution

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

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

রেসপন্স

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

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে 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 প্রপার্টির ভ্যালুতে সর্বাধিক ১০০০০ অক্ষর থাকতে পারে।
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 প্রপার্টির ভ্যালু ১ থেকে ১২৮ অক্ষরের মধ্যে হতে হবে।
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 কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।