LiveBroadcasts: cuepoint

একটি লাইভ সম্প্রচারে একটি কিউপয়েন্ট সন্নিবেশ করান৷ কিউপয়েন্ট একটি বিজ্ঞাপন বিরতি ট্রিগার হতে পারে.

দ্রষ্টব্য: এই পদ্ধতিটি liveCuepoints.insert পদ্ধতিকে প্রতিস্থাপন করে, যার জন্য YouTube বিষয়বস্তুর মালিকের সাথে যুক্ত একটি অ্যাকাউন্টের দ্বারা অনুমোদিত হওয়ার অনুরোধ প্রয়োজন৷ এই পদ্ধতিতে একই অনুমোদনের প্রয়োজনীয়তা নেই।

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/youtube/v3/liveBroadcasts/cuepoint

অনুমোদন

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

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

পরামিতি

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

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

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

অনুরোধের বডিতে একটি cuepoint রিসোর্স প্রদান করুন। নিম্নলিখিত JSON গঠন একটি cuepoint সম্পদের বিন্যাস দেখায়:

{
    "id": string,
    "insertionOffsetTimeMs": long,
    "walltimeMs": datetime,
    "durationSecs": unsigned integer,
    "cueType": string
  }
অনুরোধের বডিতে, cueType ক্ষেত্রটি প্রয়োজন এবং এটি অবশ্যই cueTypeAd সেট করতে হবে। আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:
  • durationSecs
  • insertionOffsetTimeMs ( walltimeMs সেট করা থাকলে সেট করা উচিত নয়)
  • walltimeMs (অবশ্যই সেট করা যাবে না যদি insertionOffsetTimeMs সেট করা থাকে)

বৈশিষ্ট্য

নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

বৈশিষ্ট্য
id string
একটি মান যা ইউটিউব নির্দিষ্টভাবে কিউপয়েন্ট সনাক্ত করতে বরাদ্দ করে৷ মনে রাখবেন যে এই মানটি প্রয়োজনীয় id প্যারামিটার থেকে আলাদা, যা সম্প্রচারকে চিহ্নিত করে। একটি কিউপয়েন্ট সন্নিবেশ করার অনুরোধ পাঠানোর সময় এই মানটি বাদ দেওয়া যেতে পারে। মানটি API প্রতিক্রিয়াতে পপুলেট করা হবে।
insertionOffsetTimeMs long
সম্পত্তি মান মিলিসেকেন্ডে একটি সময় অফসেট সনাক্ত করে, যখন কিউপয়েন্ট ঢোকানো উচিত। মানটি মনিটর স্ট্রীমের শুরু থেকে পরিমাপ করা হয়, এবং এর ডিফল্ট মান হল 0 , যা নির্দেশ করে যে যত তাড়াতাড়ি সম্ভব কিউপয়েন্ট সন্নিবেশ করা উচিত। আপনার সম্প্রচারে মনিটর স্ট্রীম না থাকলে এই প্যারামিটারের জন্য একটি মান নির্দিষ্ট করা উচিত নয়।

যদিও মিলিসেকেন্ডে পরিমাপ করা হয়, মানটি আসলে একটি আনুমানিক, এবং YouTube সেই সময় যতটা সম্ভব ঘনিষ্ঠভাবে কিউপয়েন্ট সন্নিবেশ করবে।

এই ক্ষেত্রের জন্য অ-শূন্য মান সমর্থিত হয় শুধুমাত্র যদি সম্প্রচার স্ট্রীম বিলম্বিত হয়। যদি আপনার সম্প্রচার স্ট্রীম বিলম্বিত না হয়, তাহলে 0 হল একমাত্র বৈধ মান। আরো বিস্তারিত জানার জন্য শুরু করার নির্দেশিকা দেখুন।

দ্রষ্টব্য: যদি আপনার সম্প্রচারের একটি পরীক্ষার পর্যায় থাকে, তবে পরীক্ষার পর্যায় শুরু হওয়ার সময় থেকে অফসেট পরিমাপ করা হয়।

এপিআই একটি ত্রুটি প্রদান করে যদি একটি অনুরোধ একটি কিউপয়েন্ট সন্নিবেশ করার চেষ্টা করে যা এই সম্পত্তি এবং walltimeMs সম্পত্তির জন্য একটি মান নির্দিষ্ট করে।
walltimeMs integer
সম্পত্তি মান প্রাচীর ঘড়ির সময় নির্দিষ্ট করে যেখানে কিউপয়েন্ট ঢোকানো উচিত। মান হল একটি পূর্ণসংখ্যা যা একটি যুগের টাইমস্ট্যাম্প (মিলিসেকেন্ডে) প্রতিনিধিত্ব করে।

এপিআই একটি ত্রুটি প্রদান করে যদি একটি অনুরোধ একটি কিউপয়েন্ট সন্নিবেশ করার চেষ্টা করে যা এই সম্পত্তির জন্য এবং insertionOffsetTimeMs সম্পত্তির জন্য একটি মান নির্দিষ্ট করে।
durationSecs unsigned integer
কিউপয়েন্টের সময়কাল, সেকেন্ডে। মান অবশ্যই একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে। ডিফল্ট মান হল 30 ।
cueType string
কিউপয়েন্টের ধরন। সম্পত্তির মান অবশ্যই cueTypeAd এ সেট করতে হবে।

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

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

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
insufficientPermissions (403) insufficientLivePermissions অনুরোধটি লাইভ সম্প্রচারে একটি কিউপয়েন্ট সন্নিবেশ করার জন্য অনুমোদিত নয়।
insufficientPermissions (403) liveStreamingNotEnabled অনুরোধটি অনুমোদনকারী ব্যবহারকারী YouTube-এ লাইভ ভিডিও স্ট্রিম করতে সক্ষম নয়। ব্যবহারকারী https://support.google.com/youtube/answer/2474026 এবং https://www.youtube.com/features- এ আরও তথ্য পেতে পারেন।
rateLimitExceeded (403) userRequestsExceedRateLimit ব্যবহারকারী একটি নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ পাঠিয়েছেন।
required (400) idRequired প্রয়োজনীয় id প্যারামিটারটি অবশ্যই সেই সম্প্রচার সনাক্ত করতে হবে যেখানে আপনি একটি কিউপয়েন্ট সন্নিবেশ করতে চান৷
required (400) cueTypeRequired প্রয়োজনীয় cueType ক্ষেত্র অবশ্যই API অনুরোধের বডিতে নির্দিষ্ট করতে হবে।
notFound (404) liveBroadcastNotFound id প্যারামিটার দ্বারা নির্দিষ্ট করা সম্প্রচারের অস্তিত্ব নেই৷
invalidValue (400) conflictingTimeFields insertionOffsetTimeMs এবং walltimeMs এর মধ্যে শুধুমাত্র একটি নির্দিষ্ট করা যেতে পারে। উভয় মান সেট করা একটি ত্রুটি ঘটায়। আপনি যদি উভয় মান সেট না করেন, তাহলে YouTube ডিফল্ট insertionOffsetTimeMs সময় ( 0 ) ব্যবহার করবে, যার অর্থ হল যত তাড়াতাড়ি সম্ভব কিউপয়েন্ট ঢোকানো হবে।
invalidValue (400) invalidInsertionOffsetTimeMs cuepoint রিসোর্স insertionOffsetTimeMs বৈশিষ্ট্যের জন্য একটি অবৈধ মান নির্দিষ্ট করেছে। মান অবশ্যই 0 বা একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে।
invalidValue (400) invalidWalltimeMs cuepoint সংস্থান walltimeMs সম্পত্তির জন্য একটি অবৈধ মান নির্দিষ্ট করেছে৷ মানটি অবশ্যই একটি পূর্ণসংখ্যা হতে হবে যা একটি যুগের টাইমস্ট্যাম্প (মিলিসেকেন্ডে) উপস্থাপন করে।
backendError (5xx) serviceUnavailable পরিষেবাটি অনুপলব্ধ৷ কয়েক মিনিট পরে আবার আপনার অনুরোধ চেষ্টা করুন.

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

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