LiveStreams: update

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

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

অনুরোধ

HTTP অনুরোধ

PUT 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 , এবং status ।

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

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

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

এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণের শংসাপত্র প্রদান না করেই বিষয়বস্তুর মালিকদের একবার প্রমাণীকরণ করতে এবং প্যারামিটার মানতে নির্দিষ্ট চ্যানেলের পক্ষে ক্রিয়া সম্পাদন করতে দেয়।

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

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

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

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

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

    • snippet.title
    • snippet.description

    আপনি যদি একটি আপডেটের অনুরোধ জমা দেন এবং আপনার অনুরোধে এমন একটি সম্পত্তির জন্য একটি মান উল্লেখ না করে যার ইতিমধ্যে একটি মান রয়েছে, তাহলে সম্পত্তির বিদ্যমান মানটি মুছে ফেলা হবে৷

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

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

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা 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-এ লাইভ ভিডিও স্ট্রিম করতে সক্ষম নয়। ব্যবহারকারী https://www.youtube.com/features এ আরও তথ্য পেতে পারেন।
invalidValue (400) invalidDescription liveStream রিসোর্সে snippet.description প্রপার্টির মান 10000 অক্ষর পর্যন্ত থাকতে পারে।
invalidValue (400) invalidTitle লাইভস্ট্রিম রিসোর্সে snippet.title প্রপার্টির মান অবশ্যই 1 থেকে 128 অক্ষরের মধ্যে হতে হবে।
notFound (404) liveStreamNotFound নির্দিষ্ট লাইভ স্ট্রিম বিদ্যমান নেই.
required (400) idRequired লাইভস্ট্রিম রিসোর্স id প্রপার্টির জন্য একটি মান নির্দিষ্ট করতে হবে।
required (400) ingestionTypeRequired লাইভস্ট্রিম রিসোর্সকে অবশ্যই cdn.ingestionType প্রপার্টির জন্য একটি মান উল্লেখ করতে হবে।
required (400) titleRequired লাইভস্ট্রিম রিসোর্সকে অবশ্যই snippet.title প্রপার্টির জন্য একটি মান উল্লেখ করতে হবে।

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

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