LiveBroadcasts: cuepoint

লাইভ ব্রডকাস্টে কিউপয়েন্ট যোগ করে। কিউপয়েন্ট বিজ্ঞাপন বিরতি ট্রিগার করতে পারে।

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

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

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

সুযোগ
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 YouTube-এর অ্যাসাইন করা একটি ভ্যালু যা অনন্যভাবে কিউপয়েন্ট শনাক্ত করে। মনে রাখবেন যে এই ভ্যালু প্রয়োজনীয় id প্যারামিটারের থেকে আলাদা, যা ব্রডকাস্ট শনাক্ত করে। একটি কিউপয়েন্ট যোগ করার অনুরোধ পাঠানোর সময় এই ভ্যালু বাদ দেওয়া যেতে পারে। API রেসপন্সে ভ্যালু দেখানো হবে।
insertionOffsetTimeMs	long প্রপার্টি ভ্যালু থেকে জানা যায় যে মিলিসেকেন্ডে কত সময় অফসেট হলে কিউপয়েন্ট যোগ করা উচিত। মনিটর স্ট্রিমের শুরু থেকে এই ভ্যালু পরিমাপ করা হয় এবং এর ডিফল্ট ভ্যালু হল 0, যা ইঙ্গিত করে যে যত তাড়াতাড়ি সম্ভব কিউপয়েন্ট যোগ করা উচিত। আপনার ব্রডকাস্টে মনিটর স্ট্রিম না থাকলে, এই প্যারামিটারের জন্য কোনও ভ্যালু নির্দিষ্ট করবেন না। মিলিসেকেন্ডে পরিমাপ করা হলেও, এই ভ্যালু আসলে আনুমানিক এবং YouTube যতটা সম্ভব সেই সময়ের কাছাকাছি কিউপয়েন্ট যোগ করবে। এই ফিল্ডের জন্য শূন্য নয় এমন মান তখনই কাজ করে যদি ব্রডকাস্ট স্ট্রিম বিলম্বিত হয়। আপনার ব্রডকাস্ট স্ট্রিমে দেরি না হলে, 0 হল একমাত্র বৈধ ভ্যালু। আরও জানতে, শুরু করা দেখুন। মনে রাখবেন: আপনার ব্রডকাস্টে টেস্টিং ফেজ থাকলে, টেস্টিং ফেজ শুরু হওয়ার সময় থেকে অফসেট পরিমাপ করা হয়। কোনও অনুরোধ যদি এমন কোনও কিউপয়েন্ট যোগ করার চেষ্টা করে যা এই প্রপার্টি এবং walltimeMs প্রপার্টির জন্য কোনও ভ্যালু নির্দিষ্ট করে, তাহলে API একটি সমস্যার মেসেজ দেখায়।
walltimeMs	integer প্রপার্টির ভ্যালু থেকে সেই ওয়াল ক্লক টাইম বোঝা যায় যেটিতে কিউপয়েন্ট যোগ করতে হবে। মানটি হল একটি পূর্ণসংখ্যা যা একটি ইপক টাইমস্ট্যাম্প (মিলি সেকেন্ডে) দেখায়। এই প্রপার্টির জন্য একটি মান নির্দিষ্ট করে এমন একটি কিউপয়েন্ট যোগ করার চেষ্টা করলে API একটি অনুরোধে একটি সমস্যা দেখায় এবং insertionOffsetTimeMs প্রপার্টিতে সমস্যা হয়।
durationSecs	unsigned integer কিউপয়েন্টের সময়সীমা, সেকেন্ডে। মানটি অবশ্যই একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে। ডিফল্ট মান হল 30।
cueType	string কিউপয়েন্টের ধরন। প্রপার্টির ভ্যালু অবশ্যই cueTypeAd-এ সেট করতে হবে।

রেসপন্স

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

সমস্যা

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

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
insufficientPermissions (403)	insufficientLivePermissions	লাইভ ব্রডকাস্টে কিউপয়েন্ট যোগ করার জন্য অনুরোধটি অনুমোদিত নয়।
insufficientPermissions (403)	liveStreamingNotEnabled	যে ব্যবহারকারী অনুরোধ অনুমোদন করেছেন, তিনি YouTube-এ লাইভ ভিডিও স্ট্রিম করার জন্য অনুমোদিত নন। ব্যবহারকারী লাইভ স্ট্রিমিং শুরু করুন এবং ফিচারের উপযুক্ততা থেকে আরও তথ্য পেতে পারেন।
rateLimitExceeded (403)	userRequestsExceedRateLimit	ব্যবহারকারী নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ করেছেন।
required (400)	idRequired	প্রয়োজনীয় id প্যারামিটারকে অবশ্যই সেই ব্রডকাস্ট শনাক্ত করতে হবে যেখানে আপনি কিউপয়েন্ট যোগ করতে চান।
required (400)	cueTypeRequired	API অনুরোধের বডিতে প্রয়োজনীয় cueType ফিল্ড উল্লেখ করতে হবে।
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 কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।