LiveBroadcasts: update

একটি সম্প্রচার আপডেট করে। উদাহরণস্বরূপ, আপনি liveBroadcast রিসোর্সের contentDetails অবজেক্টে সংজ্ঞায়িত সম্প্রচার সেটিংস পরিবর্তন করতে পারেন।

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

অনুরোধ

HTTP অনুরোধ 

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

অনুমোদন

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

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

পরামিতি

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

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

প্যারামিটারের মানটিতে আপনি যে part বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে পারেন তা হল id , snippet , contentDetails , monetizationDetails , এবং status ৷

মনে রাখবেন যে এই পদ্ধতিটি সমস্ত পরিবর্তনযোগ্য বৈশিষ্ট্যগুলির জন্য বিদ্যমান মানগুলিকে ওভাররাইড করবে যা প্যারামিটার মান নির্দিষ্ট করে এমন কোনও অংশে রয়েছে। উদাহরণস্বরূপ, একটি সম্প্রচারের গোপনীয়তার অবস্থা status অংশে সংজ্ঞায়িত করা হয়। যেমন, আপনার অনুরোধ যদি একটি ব্যক্তিগত বা তালিকাবিহীন সম্প্রচার আপডেট করে, এবং অনুরোধের part প্যারামিটারের মানটিতে 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.scheduledStartTime
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs

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

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • monetizationDetails.cuepointSchedule.pauseAdsUntil

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

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

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

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
forbidden (403) closedCaptionsTypeModificationNotAllowed contentDetails.closedCaptionsType মান শুধুমাত্র তখনই পরিবর্তন করা যেতে পারে যখন সম্প্রচারটি created বা ready অবস্থায় থাকে।
forbidden (403) enabledModificationNotAllowed enabled ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।
forbidden (403) scheduleStrategyModificationNotAllowed scheduleStrategy ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।
forbidden (403) repeatIntervalSecsModificationNotAllowed repeatIntervalSecs ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।
forbidden (403) pauseAdsUntilModificationNotAllowed pauseAdsUntil ক্ষেত্রের পরিবর্তন করা যাবে না। এই ত্রুটি নিম্নলিখিত কারণে ঘটতে পারে:
  • monetizationDetails.cuepointSchedule.enabled ক্ষেত্রটি true হিসাবে সেট করা নেই। এই ক্ষেত্রটি শুধুমাত্র YouTube স্টুডিও ব্যবহার করে সেট করা যেতে পারে।
  • সম্প্রচারটি লাইভ নয়।
forbidden (403) enableAutoStartModificationNotAllowed contentDetails.enableAutoStart মান শুধুমাত্র তখনই পরিবর্তন করা যেতে পারে যখন স্ট্রিমটি নিষ্ক্রিয় থাকে এবং সম্প্রচার created বা ready অবস্থায় থাকে।
forbidden (403) enableClosedCaptionsModificationNotAllowed contentDetails.enableClosedCaptions মান শুধুমাত্র তখনই পরিবর্তন করা যেতে পারে যখন সম্প্রচারের স্থিতি created বা ready হয়৷
forbidden (403) enableDvrModificationNotAllowed contentDetails. enableDvr সম্প্রচারের স্থিতি created বা ready হলেই contentDetails. enableDvr মান পরিবর্তন করা যেতে পারে।
forbidden (403) enableMonitorStreamModificationNotAllowed contentDetails. monitorStream.enableMonitorStream মান শুধুমাত্র তখনই পরিবর্তন করা যেতে পারে যখন সম্প্রচারের স্থিতি created বা ready হয়।
forbidden (403) recordFromStartModificationNotAllowed contentDetails. recordFromStart মান শুধুমাত্র তখনই পরিবর্তন করা যেতে পারে যখন সম্প্রচারের স্থিতি created বা ready ।
insufficientPermissions insufficientLivePermissions অনুরোধটি নির্দিষ্ট লাইভ সম্প্রচার আপডেট করার জন্য অনুমোদিত নয়। আরও তথ্যের জন্য, OAuth2 প্রমাণীকরণ বাস্তবায়ন দেখুন।
insufficientPermissions liveStreamingNotEnabled অনুরোধটি অনুমোদনকারী ব্যবহারকারী YouTube-এ লাইভ ভিডিও স্ট্রিম করতে সক্ষম নয়। ব্যবহারকারী https://www.youtube.com/features এ আরও তথ্য পেতে পারেন।
invalidValue (400) invalidAutoStart লাইভব্রডকাস্ট রিসোর্সে contentDetails.enableAutoStart প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। আপনি একটি অবিরাম সম্প্রচারের জন্য enableAutoStart সেটিং পরিবর্তন করতে পারবেন না৷
invalidValue (400) invalidAutoStop লাইভব্রডকাস্ট রিসোর্সে contentDetails.enableAutoStop প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। আপনি একটি অবিরাম সম্প্রচারের জন্য enableAutoStop সেটিং পরিবর্তন করতে পারবেন না৷
invalidValue (400) invalidDescription liveBroadcast সম্পদ snippet.description প্রপার্টির জন্য একটি বৈধ মান নির্দিষ্ট করেনি। snippet.description 5000 অক্ষর পর্যন্ত থাকতে পারে।
invalidValue (400) invalidEmbedSetting লাইভব্রডকাস্ট রিসোর্সে contentDetails.enable_embed প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। আপনি এই সম্প্রচার এম্বেড করতে পারবেন না.
invalidValue (400) invalidEnableClosedCaptions লাইভব্রডকাস্ট রিসোর্সে , contentDetails.enableClosedCaptions প্রপার্টির মান contentDetails.closedCaptionType সেটিং এর মানের সাথে সামঞ্জস্যপূর্ণ নয়। শুধুমাত্র দুটি বৈশিষ্ট্যের মধ্যে একটি অন্তর্ভুক্ত করতে সংস্থানটি পরিবর্তন করুন এবং তারপরে অনুরোধটি পুনরায় জমা দিন।
invalidValue (400) invalidLatencyPreferenceOptions লাইভব্রডকাস্ট রিসোর্সে contentDetails.latencyPreference প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। সমস্ত সেটিংস এই লেটেন্সি পছন্দের সাথে সমর্থিত নয়৷
invalidValue (400) invalidPauseAdsUntil লাইভব্রডকাস্ট সংস্থানে monetizationDetails.cuepointSchedule.pauseAdsUntil সম্পত্তির জন্য একটি অবৈধ মান রয়েছে৷ এই ত্রুটি নিম্নলিখিত কারণে ঘটতে পারে:
  • monetizationDetails.cuepointSchedule.pauseAdsUntil মান ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) ফর্ম্যাটে নির্দিষ্ট করা নেই৷
  • monetizationDetails.cuepointSchedule.pauseAdsUntil মান ভবিষ্যতে নেই৷
  • monetizationDetails.cuepointSchedule.pauseAdsUntil মান বর্তমান সময় থেকে 10 মিনিটের বেশি।
invalidValue (400) invalidPrivacyStatus লাইভব্রডকাস্ট সংস্থান একটি বৈধ গোপনীয়তা স্থিতি নির্দিষ্ট করেনি। বৈধ privacyStatus মান দেখুন।
invalidValue (400) invalidProjection লাইভব্রডকাস্ট রিসোর্সে contentDetails.projection প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। একটি অবিরাম সম্প্রচারের অভিক্ষেপ 360 এ সেট করা যাবে না৷
invalidValue (400) invalidScheduledEndTime লাইভব্রডকাস্ট সংস্থানটিতে snippet.scheduledEndTime সম্পত্তির জন্য একটি অবৈধ মান রয়েছে৷ নির্ধারিত শেষ সময় অবশ্যই নির্ধারিত শুরুর সময় অনুসরণ করবে।
invalidValue (400) invalidScheduledStartTime লাইভব্রডকাস্ট রিসোর্সে snippet.scheduledStartTime প্রপার্টির জন্য একটি অবৈধ মান রয়েছে। নির্ধারিত শুরুর সময় অবশ্যই ভবিষ্যতে হতে হবে।
invalidValue (400) invalidTitle liveBroadcast সম্পদ snippet.title প্রপার্টির জন্য একটি বৈধ মান নির্দিষ্ট করেনি। snippet.title অবশ্যই 1 থেকে 100 অক্ষরের মধ্যে হতে হবে৷
notFound (404) liveBroadcastNotFound লাইভব্রডকাস্ট রিসোর্সে নির্দিষ্ট করা id সম্পত্তি একটি সম্প্রচার সনাক্ত করেনি।
required (400) broadcastStreamDelayMsRequired লাইভব্রডকাস্ট সংস্থান contentDetails. monitorStream.broadcastStreamDelayMs সম্পত্তি।
required (400) enableMonitorStreamRequired লাইভব্রডকাস্ট সংস্থান contentDetails. monitorStream.enableMonitorStream সম্পত্তি।
required (400) idRequired লাইভব্রডকাস্ট রিসোর্সে অবশ্যই id প্রপার্টির জন্য একটি মান অন্তর্ভুক্ত এবং নির্দিষ্ট করতে হবে।
required (400) scheduledEndTimeRequired লাইভব্রডকাস্ট সংস্থান snippet.scheduledEndTime সম্পত্তি নির্দিষ্ট করেনি।
required (400) scheduledStartTimeRequired লাইভব্রডকাস্ট সংস্থান snippet.scheduledStartTime সম্পত্তি নির্দিষ্ট করেনি।

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

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