LiveCuepoints

liveCuepoint রিসোর্স এবং liveCuepoints.insert পদ্ধতি অবচয় করা হয়েছে এবং liveBroadcasts.cuepoint পদ্ধতি দ্বারা প্রতিস্থাপিত হয়েছে।

একটি liveCuepoint সংস্থান সম্প্রচার ভিডিও স্ট্রীমে একটি কিউপয়েন্ট সন্নিবেশ করায়, যা একটি বিজ্ঞাপন বিরতি ট্রিগার করতে পারে।

দ্রষ্টব্য: এই API কমান্ডটি আসলে YouTube Content ID API এর অংশ এবং liveBroadcast এবং liveStream সংস্থানগুলি পরিচালনা করার অনুরোধের চেয়ে আলাদা অনুমোদনের প্রয়োজনীয়তা রয়েছে৷

পদ্ধতি

API liveCuepoints সংস্থানগুলির জন্য নিম্নলিখিত পদ্ধতিগুলিকে সমর্থন করে:

insert
একটি লাইভ সম্প্রচারে একটি কিউপয়েন্ট সন্নিবেশ করান৷ বর্তমানে, এই পদ্ধতির অনুরোধ একটি YouTube বিষয়বস্তুর মালিকের সাথে যুক্ত একটি অ্যাকাউন্ট দ্বারা অনুমোদিত হতে হবে৷ এখনই চেষ্টা করে দেখুন

সম্পদ প্রতিনিধিত্ব

নিম্নলিখিত JSON গঠন একটি liveCuepoints সম্পদের বিন্যাস দেখায়:

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

বৈশিষ্ট্য

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

বৈশিষ্ট্য
id string
একটি মান যা ইউটিউব নির্দিষ্টভাবে কিউপয়েন্ট সনাক্ত করতে বরাদ্দ করে৷
kind string
API সম্পদের ধরন। liveCuepoint সম্পদের জন্য, মান হল youtubePartner#liveCuepoint
broadcastId string
কিউপয়েন্ট যে সম্প্রচারে ঢোকানো হচ্ছে সেটিকে অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি বরাদ্দ করে।
settings object
settings অবজেক্ট কিউপয়েন্টের সেটিংস সংজ্ঞায়িত করে।
settings. offsetTimeMs long
এই মানটি ভিডিওতে একটি সময় নির্দিষ্ট করে যখন দর্শকদের একটি বিজ্ঞাপন বা ইন-স্ট্রীম স্লেট দেখতে হবে৷ সম্পত্তি মান মনিটর স্ট্রীমের শুরু থেকে মিলিসেকেন্ডে একটি সময় অফসেট সনাক্ত করে। যদিও মিলিসেকেন্ডে পরিমাপ করা হয়, মানটি আসলে একটি আনুমানিক, এবং YouTube সেই সময় যতটা সম্ভব ঘনিষ্ঠভাবে কিউপয়েন্ট সন্নিবেশ করবে। আপনার সম্প্রচারে মনিটর স্ট্রীম না থাকলে এই প্যারামিটারের জন্য একটি মান নির্দিষ্ট করা উচিত নয়।

এই সম্পত্তির ডিফল্ট মান হল 0 , যা নির্দেশ করে যে যত তাড়াতাড়ি সম্ভব কিউপয়েন্ট সন্নিবেশ করা উচিত। যদি আপনার সম্প্রচার স্ট্রীম বিলম্বিত না হয়, তাহলে 0 হল একমাত্র বৈধ মান। যাইহোক, যদি আপনার সম্প্রচার স্ট্রীম বিলম্বিত হয়, তাহলে সম্পত্তি মান নির্দিষ্ট করতে পারে কখন কিউপয়েন্ট ঢোকানো হবে। আরো বিস্তারিত জানার জন্য শুরু করার নির্দেশিকা দেখুন।

দ্রষ্টব্য: যদি আপনার সম্প্রচারের একটি পরীক্ষার পর্যায় থাকে, তবে পরীক্ষার পর্যায় শুরু হওয়ার সময় থেকে অফসেট পরিমাপ করা হয়।
settings. walltime datetime
এই মানটি প্রাচীর ঘড়ির সময় নির্দিষ্ট করে যেখানে কিউপয়েন্ট ঢোকানো উচিত। মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ) ফর্ম্যাটে নির্দিষ্ট করা হয়েছে৷

এপিআই একটি ত্রুটি প্রদান করে যদি একটি অনুরোধ একটি কিউপয়েন্ট সন্নিবেশ করার চেষ্টা করে যা এই বৈশিষ্ট্য এবং settings.offsetTimeMs সম্পত্তির জন্য একটি মান নির্দিষ্ট করে।
settings. cueType string
কিউপয়েন্টের ধরন। বিভিন্ন ধরণের কিউপয়েন্টের ব্যাখ্যার জন্য শুরু করা নির্দেশিকাটি দেখুন। এছাড়াও আপনার সম্প্রচারের সময় কিউপয়েন্ট সন্নিবেশ করার সর্বোত্তম অনুশীলনের জন্য একটি সম্প্রচার নথির জীবন দেখুন।

এই সম্পত্তির জন্য বৈধ মান হল:
  • ad
settings. durationSecs unsigned integer
কিউপয়েন্টের সময়কাল, সেকেন্ডে। এই মানটি অবশ্যই নির্দিষ্ট করতে হবে যদি cueType ad হয় এবং অন্যথায় উপেক্ষা করা হয়।