LiveStreams: update

ভিডিও স্ট্রিম আপডেট করে। আপনি যে প্রপার্টি পরিবর্তন করতে চান সেটি আপডেট করা না গেলে, আপনাকে সঠিক সেটিংস সহ নতুন স্ট্রিম তৈরি করতে হবে।

সাধারণ ব্যবহারিক প্রয়োগ

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপগুলির মধ্যে অন্তত একটির সাথে অনুমোদনের প্রয়োজন। যাচাইকরণ ও অনুমোদন সম্পর্কে আরও জানতে, OAuth 2.0 অনুমোদন প্রয়োগ করা দেখুন।

সুযোগ
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকায় থাকা সব প্যারামিটারই হল কোয়েরি প্যারামিটার।

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part string
এই অপারেশনে part প্যারামিটার দুটি উদ্দেশ্যে কাজ করে। এটি সেইসব প্রপার্টি শনাক্ত করে যেগুলি রাইট অপারেশন সেট করবে এবং সেইসব প্রপার্টিও শনাক্ত করে যেগুলি এপিআই রেসপন্সে অন্তর্ভুক্ত থাকবে।

প্যারামিটার ভ্যালুতে আপনি যেসব part প্রপার্টি অন্তর্ভুক্ত করতে পারবেন সেগুলি হল id, snippet, cdn ও status।

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

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

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

এই প্যারামিটারটি সেইসব YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিককে একবার যাচাইকরণ করার এবং প্রতিটি আলাদা চ্যানেলের জন্য যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই প্যারামিটারের মানে নির্দিষ্ট করা চ্যানেলের হয়ে অ্যাকশন নেওয়ার অনুমতি দেয়।

অনুরোধের বডি

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

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

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

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

    • snippet.title
    • snippet.description

    আপনি যদি কোনও আপডেটের অনুরোধ জমা দেন এবং আপনার অনুরোধে আগে থেকেই ভ্যালু আছে এমন কোনও প্রপার্টির ভ্যালু উল্লেখ না করেন, তাহলে প্রপার্টির বর্তমান ভ্যালু মুছে যাবে।

রেসপন্স

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

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
forbidden (403) liveStreamModificationNotAllowed নির্দিষ্ট করা লাইভ স্ট্রিমটি তার বর্তমান অবস্থায় পরিবর্তন করা যাবে না। আরও তথ্যের জন্য, ব্রডকাস্টের লাইফ দেখুন।
forbidden (403) liveStreamModificationNotAllowed স্ট্রিম তৈরি করার পরে API আপনাকে cdn.format, cdn.frameRate, cdn.ingestionType বা cdn.resolution ফিল্ডের ভ্যালু পরিবর্তন করতে দেয় না।
forbidden (403) liveStreamModificationNotAllowed API আপনাকে আবার ব্যবহার করা যায় এমন স্ট্রিমকে আবার ব্যবহার করা যায় না এমন স্ট্রিমে পরিবর্তন করতে দেয় না বা এর উল্টোটাও করতে দেয় না। আরও তথ্যের জন্য, ব্রডকাস্ট ও স্ট্রিম সম্পর্কে বোঝা দেখুন।
insufficientPermissions insufficientLivePermissions নির্দিষ্ট লাইভ স্ট্রিম আপডেট করার জন্য অনুরোধটি অনুমোদিত নয়। আরও তথ্যের জন্য, OAuth2 যাচাইকরণ প্রয়োগ করা দেখুন।
insufficientPermissions liveStreamingNotEnabled যে ব্যবহারকারী অনুরোধ অনুমোদন করেছেন, তিনি YouTube-এ লাইভ ভিডিও স্ট্রিম করার জন্য অনুমোদিত নন। ব্যবহারকারী ফিচারের উপযুক্ততা লিঙ্কে গিয়ে আরও তথ্য পেতে পারেন।
invalidValue (400) invalidDescription liveStream রিসোর্সে snippet.description প্রপার্টির ভ্যালুতে সর্বাধিক ১০০০০ অক্ষর থাকতে পারে।
invalidValue (400) invalidTitle liveStream রিসোর্সে snippet.title প্রপার্টির ভ্যালু ১ থেকে ১২৮ অক্ষরের মধ্যে হতে হবে।
notFound (404) liveStreamNotFound উল্লেখ করা লাইভ স্ট্রিমটি উপলভ্য নেই।
required (400) idRequired liveStream রিসোর্স-এ অবশ্যই id প্রপার্টির জন্য একটি মান উল্লেখ করতে হবে।
required (400) ingestionTypeRequired liveStream রিসোর্স-এ অবশ্যই cdn.ingestionType প্রপার্টির জন্য একটি মান উল্লেখ করতে হবে।
required (400) titleRequired liveStream রিসোর্স-এ অবশ্যই snippet.title প্রপার্টির জন্য একটি মান উল্লেখ করতে হবে।

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

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