এই পৃষ্ঠায় YouTube লাইভ স্ট্রিমিং API পরিবর্তন এবং ডকুমেন্টেশন আপডেটের তালিকা রয়েছে। এই চেঞ্জলগে সাবস্ক্রাইব করুন ।
১২ জানুয়ারী, ২০২৬
API এখন লাইভ সম্প্রচারের জন্য মিডরোল সক্ষম করা এবং স্বয়ংক্রিয় মিডরোল সন্নিবেশ সমর্থন করে।
সম্প্রচারের মালিক কোনও সম্প্রচারের জন্য মিডরোলগুলি সক্ষম করতে পারেন যতক্ষণ না সম্প্রচারটি মিডরোলগুলির জন্য যোগ্য হয়। মালিক যেকোনো সময় সম্প্রচারের জন্য মিডরোলগুলি বন্ধও করতে পারেন।
যদি মিডরোলগুলির জন্য কোনও সম্প্রচার সক্ষম করা থাকে, তাহলে সম্প্রচারের মালিক স্বয়ংক্রিয় মিডরোল সন্নিবেশ সক্ষম করতে পারেন। তারা যেকোনো সময় সম্প্রচারের জন্য স্বয়ংক্রিয় বিজ্ঞাপনগুলি বন্ধও করতে পারেন।
যখন সম্প্রচারের মালিক স্বয়ংক্রিয় বিজ্ঞাপন সক্ষম করেন, তখন মালিক নিম্নলিখিত বিকল্পগুলির মধ্যে একটি বেছে নিতে পারেন:
- YouTube-কে মিড-রোল ইনসার্টেশন অপ্টিমাইজ করতে দিন। এই বিকল্পটি তিনটি মোড সমর্থন করে:
- কম: কম উপার্জনের সম্ভাবনা, কম বাধাগ্রস্ত দর্শক অভিজ্ঞতা
- মাঝারি: মাঝারি আয়ের সম্ভাবনা, সুষম দর্শক অভিজ্ঞতা
- উচ্চ: উচ্চ আয়ের সম্ভাবনা, আরও বাধাগ্রস্ত দর্শক অভিজ্ঞতা
- মিড-রোল ইনসার্টের জন্য কৌশল এবং ব্যবধান ম্যানুয়ালি কনফিগার করুন। এই ক্ষেত্রে, মালিককে দুটি প্যারামিটার সেট আপ করতে হবে:
- বিজ্ঞাপন কিউপয়েন্টের জন্য সময় নির্ধারণ কৌশল। সকল দর্শকের জন্য কিউপয়েন্ট একসাথে সন্নিবেশ করা যেতে পারে অথবা কিউপয়েন্টের সময় দর্শক থেকে দর্শকের মধ্যে পরিবর্তিত হতে পারে। পরবর্তী কৌশলটি YouTube কে বর্ধিত হারে কিউপয়েন্ট নির্ধারণ করতে সক্ষম করে যা দর্শকদের যোগ্য হলে কিউপয়েন্ট গ্রহণ করতে দেয়।
- মিড-রোল বিজ্ঞাপন বিরতির মধ্যে ব্যবধানের দৈর্ঘ্য।
এই বৈশিষ্ট্যটি সমর্থন করার জন্য ডকুমেন্টেশনটি নিম্নলিখিত API পরিবর্তনগুলি প্রতিফলিত করে:
-
liveBroadcastরিসোর্সেরmonetizationDetailsঅবজেক্টে মিডরোল সক্ষমকরণ এবং স্বয়ংক্রিয় বিজ্ঞাপন কনফিগারেশনের জন্য ক্ষেত্র রয়েছে। -
updateপদ্ধতিটি মিডরোল বিজ্ঞাপনগুলি সক্ষম বা অক্ষম করতে ব্যবহার করা যেতে পারে। এই পদ্ধতিটি সরাসরি সম্প্রচারের জন্য স্বয়ংক্রিয় বিজ্ঞাপনগুলি সেট আপ করতেও ব্যবহার করা যেতে পারে। ডকুমেন্টেশনটি সরাসরি সম্প্রচারের জন্য নগদীকরণ এবং স্বয়ংক্রিয় বিজ্ঞাপন সেটিংস আপডেট করার সময় ঘটতে পারে এমন বেশ কয়েকটি নতুন ত্রুটি চিহ্নিত করে।
১৪ জুলাই, ২০২৫
liveChatMessages.streamList পদ্ধতির বর্ণনা আপডেট করা হয়েছে যাতে streamList API ব্যবহারের নির্দেশিকা প্রদান করা যায়।
৯ অক্টোবর, ২০২৩
শুধুমাত্র রেফারেন্সের জন্য, এই CSV ফাইলে আপনি কোন স্টিকার আইডি কোন সুপার স্টিকারের সাথে সম্পর্কিত তা খুঁজে পেতে পারেন। liveChatMessage রিসোর্সের snippet.superStickerDetails.superStickerMetadata.stickerId প্রপার্টি এবং superChatEvent রিসোর্সের snippet.superStickerMetadata.stickerId প্রপার্টির সংজ্ঞা উভয়ই এই তথ্য প্রতিফলিত করার জন্য আপডেট করা হয়েছে।
১৫ সেপ্টেম্বর, ২০২৩
API এখন লাইভ সম্প্রচারে বিজ্ঞাপন সন্নিবেশ করার একটি নতুন উপায় সমর্থন করে। liveCuepoints ছাড়াও, যা আপনাকে ম্যানুয়ালি একটি সম্প্রচারে বিজ্ঞাপন বিরতি সন্নিবেশ করতে দেয়, YouTube এখন একটি নির্দিষ্ট বিরতিতে স্বয়ংক্রিয়ভাবে একটি সম্প্রচারে মিডরোল বিজ্ঞাপন বিরতি সন্নিবেশ করার বৈশিষ্ট্য সমর্থন করে।
যদি সম্প্রচারের মালিক স্বয়ংক্রিয় বিজ্ঞাপন সক্ষম করেন, তাহলে তারা বিজ্ঞাপন আচরণের নিম্নলিখিত দিকগুলি দেখতে পারবেন:
- মিডরোল বিজ্ঞাপন বিরতির মধ্যে ব্যবধানের দৈর্ঘ্য।
- বিজ্ঞাপন কিউপয়েন্টের জন্য সময় নির্ধারণ কৌশল। সকল দর্শকের জন্য কিউপয়েন্ট একই সাথে সন্নিবেশ করা যেতে পারে অথবা কিউপয়েন্টের সময় দর্শক থেকে দর্শকের মধ্যে পরিবর্তিত হতে পারে। পরবর্তী কৌশলটি YouTube কে বর্ধিত হারে কিউপয়েন্ট নির্ধারণ করতে সক্ষম করে যা দর্শকদের যোগ্য হলে কিউপয়েন্ট গ্রহণ করতে দেয়।
- একটি নির্দিষ্ট সময়কাল যখন মিডরোল বিজ্ঞাপন দেখানো হয় না; এই বৈশিষ্ট্যের জন্য, সম্প্রচারের মালিক নির্দিষ্ট করে দেন যে মিডরোল বিজ্ঞাপন সন্নিবেশ একটি নির্দিষ্ট সময় পর্যন্ত স্থগিত রাখা হয়েছে।
এই বৈশিষ্ট্যটি সমর্থন করার জন্য ডকুমেন্টেশনটি নিম্নলিখিত API পরিবর্তনগুলি প্রতিফলিত করে:
-
liveBroadcastরিসোর্সে এখন একটিmonetizationDetailsঅবজেক্ট রয়েছে। অবজেক্টের ক্ষেত্রগুলি নির্দেশ করে যে সম্প্রচারের জন্য স্বয়ংক্রিয় বিজ্ঞাপন সন্নিবেশ সক্ষম করা আছে কিনা এবং কিউপয়েন্ট নির্ধারণের জন্য অতিরিক্ত তথ্য নির্দিষ্ট করে। -
liveBroadcast.listপদ্ধতিরpartপ্যারামিটারmonetizationDetailsমান সমর্থন করে। - লাইভ সম্প্রচারের জন্য নির্দিষ্ট সময়ের জন্য মিডরোল বিজ্ঞাপন সন্নিবেশ স্থগিত করতে
updateপদ্ধতিটি ব্যবহার করা যেতে পারে। ডকুমেন্টেশনটি এখন লাইভ সম্প্রচারের জন্য নগদীকরণের বিবরণ আপডেট করার সময় ঘটতে পারে এমন বেশ কয়েকটি ত্রুটিও সনাক্ত করে।
১ আগস্ট, ২০২৩
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
liveBroadcasts.updateপদ্ধতিতে আর এই ক্ষেত্রগুলির জন্য মান নির্দিষ্ট করার প্রয়োজন নেই:-
snippet.title -
status.privacyStatus
অনুরোধ থেকে এই ক্ষেত্রগুলি বাদ দিলে এগুলি অপরিবর্তিত থাকবে।
-
১ নভেম্বর, ২০২২
নতুন
liveBroadcasts.cuepointপদ্ধতিটি YouTube-এ লাইভ সম্প্রচার পরিচালনাকারী যেকোনো চ্যানেল মালিককে সেই সম্প্রচারে cuepoints সন্নিবেশ করতে সক্ষম করে, যা বিজ্ঞাপন বিরতি ট্রিগার করতে পারে। এই পদ্ধতিটিliveCuepoints.insertপদ্ধতির পরিবর্তে, যা শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের লাইভ সম্প্রচারে cuepoints সন্নিবেশ করতে সক্ষম করে।এই নতুন পদ্ধতির প্রাপ্যতা প্রতিফলিত করার জন্য বেশ কয়েকটি নির্দেশিকা আপডেট করা হয়েছে।
দ্রষ্টব্য: এটি একটি অবচয় রোধের ঘোষণা।
liveCuepoints.insertপদ্ধতিটি এখন বন্ধ করে দেওয়া হয়েছে।liveCuepoints.insertপদ্ধতির জন্য সমর্থন ১ মে, ২০২৩ তারিখে বা তার পরে সরানো হবে। API ব্যবহারকারীদের তাদের অ্যাপ্লিকেশনগুলি আপডেট করেliveBroadcasts.cuepointপদ্ধতিতে কল করা উচিত।liveBroadcasts.controlপদ্ধতির ডকুমেন্টেশন সরানো হয়েছে। ২০২০ সালের সেপ্টেম্বরে এই পদ্ধতির জন্য একটি অবচয় বিজ্ঞপ্তি পোস্ট করা হয়েছিল।
১ অক্টোবর, ২০২২
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
liveBroadcasts.updateপদ্ধতিতে আর এই ক্ষেত্রগুলির জন্য মান নির্দিষ্ট করার প্রয়োজন নেই:-
contentDetails.enableContentEncryption -
contentDetails.enableDvr -
contentDetails.enableEmbed -
contentDetails.recordFromStart -
contentDetails.startWithSlate
অনুরোধ থেকে এই ক্ষেত্রগুলি বাদ দিলে এগুলি অপরিবর্তিত থাকবে।
-
অপ্রচলিত
liveBroadcastফিল্ডের জন্য ডকুমেন্টেশন সরানো হয়েছে:-
contentDetails.enableContentEncryption -
contentDetails.startWithSlate
-
১ এপ্রিল, ২০২২
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
snippet.typeপ্রপার্টি এখন দুটি নতুন মান সমর্থন করে:-
membershipGiftingEvent -
giftMembershipReceivedEvent
-
liveChatMessageরিসোর্সের নতুনsnippet.membershipGiftingDetailsপ্রপার্টি এবং এর শিশুগুলিতে Membership Gifting ইভেন্ট সম্পর্কে তথ্য রয়েছে। একইভাবে, নতুনsnippet.giftMembershipReceivedDetailsপ্রপার্টি এবং এর শিশুগুলিতে Gift Membership Received ইভেন্ট সম্পর্কে তথ্য রয়েছে।
১৫ সেপ্টেম্বর, ২০২১
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
snippet.typeপ্রপার্টি এখন দুটি নতুন মান সমর্থন করে:-
newSponsorEvent -
memberMilestoneChatEvent
-
liveChatMessageরিসোর্সের নতুনsnippet.memberMilestoneChatDetailsপ্রপার্টি এবং এর শিশু-কিশোরদের মধ্যে সদস্য মাইলস্টোন চ্যাট ইভেন্ট সম্পর্কে তথ্য রয়েছে। একইভাবে, নতুনsnippet.newSponsorDetailsপ্রপার্টি এবং এর শিশু-কিশোরদের মধ্যে নতুন স্পনসর ইভেন্ট সম্পর্কে তথ্য রয়েছে।
১ ডিসেম্বর, ২০২০
API এর liveBroadcasts.transition পদ্ধতিটি একটি নতুন 403 ( Forbidden ) ত্রুটি সমর্থন করে, যা নির্দেশ করে যে ব্যবহারকারী একটি নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ পাঠিয়েছেন। ত্রুটির কারণ হল userRequestsExceedRateLimit ।
২১ সেপ্টেম্বর, ২০২০
liveBroadcastরিসোর্সেরstatus.madeForKidsপ্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে স্পষ্ট করা যায় যে প্রপার্টিটি কেবল পঠনযোগ্য। এটি API কার্যকারিতার কোনও পরিবর্তন প্রতিফলিত করে না।একটি লাইভ সম্প্রচারকে শিশু-নির্দেশিত হিসেবে চিহ্নিত করতে, সম্প্রচার তৈরি করার জন্য
liveBroadcasts.insertপদ্ধতিটি কল করার সময়status.selfDeclaredMadeForKidsপ্রপার্টিটিকেtrueএ সেট করুন।দ্রষ্টব্য: এই পরিবর্তনের মধ্যে একটি অবচয় ঘোষণা এবং পূর্ববর্তী অবচয় ঘোষণার আপডেট অন্তর্ভুক্ত রয়েছে।
liveBroadcasts.controlপদ্ধতিটি ১ অক্টোবর ২০২০ তারিখে বা তার পরে বন্ধ করে দেওয়া হবে। সেই তারিখের পরে, এই পদ্ধতিতে সমস্ত কল একটি নিষিদ্ধ (403) ত্রুটি ফেরত দেবে এবং পরে পদ্ধতিটি সম্পূর্ণরূপে সরিয়ে ফেলা হবে। ক্লায়েন্টরা এখনও YouTube এর ইনজেশন সার্ভারে পাঠানো ভিডিওতে একটি ওভারলে যোগ করে তাদের নিজস্ব স্লেটিং বাস্তবায়ন করতে পারবেন।১৬ এপ্রিল ২০২০ তারিখে করা অবচয় ঘোষণার অবচয় তারিখ, যা মূলত ১ সেপ্টেম্বর ২০২০ তারিখে নির্ধারিত ছিল, পিছিয়ে দেওয়া হয়েছে এবং এখন ১ অক্টোবর ২০২০ তারিখে বা তার পরে তা ঘটবে। সুতরাং, সেই অবচয় ঘোষণায় অন্তর্ভুক্ত বৈশিষ্ট্যগুলি এবং
liveBroadcasts.controlপদ্ধতি একই সময়ে অবচয় করা হবে।
১৭ জুলাই, ২০২০
দ্রষ্টব্য: এটি পূর্ববর্তী একটি অবচয় ঘোষণার আপডেট।
liveStream রিসোর্সের cdn.format ফিল্ড, যা ২০১৬ সালের এপ্রিলে বন্ধ করে দেওয়া হয়েছিল, ১৭ আগস্ট ২০২০ থেকে আর সমর্থিত হবে না। সেই তারিখ থেকে এখনও সেই ফিল্ড ব্যবহার করা অনুরোধগুলি ব্যর্থ হবে।
যদি আপনার কোডটি এখনও cdn.format ক্ষেত্র ব্যবহার করে, তাহলে cdn.frameRate এবং cdn.resolution বৈশিষ্ট্য ব্যবহার করে ফ্রেম রেট এবং রেজোলিউশন আলাদাভাবে নির্দিষ্ট করার জন্য এটি আপডেট করতে হবে।
৬ জুলাই, ২০২০
HLS এর মাধ্যমে লাইভ ইউটিউব কন্টেন্ট সরবরাহ করার নির্দেশিকাটি কয়েকটি পরিবর্তন সহ আপডেট করা হয়েছে:
- একটি মিডিয়া বিভাগের জন্য প্রস্তাবিত সময়কাল এক থেকে চার সেকেন্ডে আপডেট করা হয়েছে।
- একটি নতুন বিভাগে ব্যাখ্যা করা হয়েছে কিভাবে YouTube Creator Studio থেকে HLS ইনজেশন URL পেতে হয় ।
-
fileপ্যারামিটার মান ফর্ম্যাট করার নির্দেশাবলী নতুন "HLS ইনজেশন URL সম্পূর্ণ করা" বিভাগে স্থানান্তরিত করা হয়েছে। HLS ইনজেশন URLটি YouTube API বা YouTube Creator Studio থেকে প্রাপ্ত কিনা তা নির্বিশেষে এই নির্দেশাবলী প্রযোজ্য।
এছাড়াও, নতুন ইনজেশন প্রোটোকল তুলনাতে YouTube সমর্থিত ইনজেশন প্রোটোকল, প্রতিটি প্রোটোকলের জন্য সমর্থিত কোডেক এবং প্রতিটি প্রোটোকলের জন্য উপযুক্ত ব্যবহারের ক্ষেত্রে অতিরিক্ত তথ্য তালিকাভুক্ত করা হয়েছে।
১৬ এপ্রিল, ২০২০
এই আপডেটে একটি নতুন সম্পত্তি এবং একটি অবচয় ঘোষণা অন্তর্ভুক্ত রয়েছে:
liveBroadcastরিসোর্স এখনcontentDetails.enableAutoStopপ্রপার্টি সমর্থন করে। এই প্রপার্টিটি নির্দেশ করে যে চ্যানেল মালিক বাউন্ড ভিডিও স্ট্রিমে ভিডিও স্ট্রিমিং বন্ধ করার প্রায় এক মিনিট পরে কোনও সম্প্রচার স্বয়ংক্রিয়ভাবে বন্ধ হয়ে যাবে কিনা।একটি সম্প্রচার ডকুমেন্টের জীবনকাল আপডেট করা হয়েছে যাতে ব্যাখ্যা করা যায় যে আপনি যদি
contentDetails.enableAutoStartবাcontentDetails.enableAutoStopবৈশিষ্ট্যগুলিকেtrueতে সেট করেন তবে একটি লাইভ YouTube ইভেন্ট তৈরি এবং পরিচালনা করার ধাপে ধাপে প্রক্রিয়া কীভাবে পরিবর্তিত হয়।দ্রষ্টব্য: এটি একটি অবচয় প্রত্যাহারের ঘোষণা। এই পরিবর্তনগুলি ১ সেপ্টেম্বর, ২০২০ তারিখে বা তার পরে কার্যকর হবে। পরিবর্তনগুলি কার্যকর হওয়ার প্রকৃত তারিখটি নীচে অবচয় প্রত্যাহারের তারিখ হিসাবে উল্লেখ করা হয়েছে।
এই আপডেটটি একটি সম্ভাব্য ভঙ্গুর পরিবর্তন ব্যাখ্যা করে। এটি এমন API ক্লায়েন্ট অ্যাপ্লিকেশনগুলিকে প্রভাবিত করে যারা YouTube-এ লাইভ কন্টেন্ট স্ট্রিম করার জন্য চ্যানেলের ডিফল্ট
liveStreamএবংliveBroadcastরিসোর্স ব্যবহার করে। বিশেষ করে, স্থায়ী সম্প্রচার এবং স্ট্রিমের সাথে যুক্ত ব্রডকাস্ট আইডি এবং স্ট্রিম আইডি আর নতুন সম্প্রচার শুরু করার জন্য কাজ করবে না।নিম্নলিখিতগুলির মধ্যে কোনটি সত্য হলে আপনার আবেদন প্রভাবিত হবে:
- এটি
liveBroadcastরিসোর্সেরisDefaultBroadcastপ্রপার্টির মান পরীক্ষা করে। অবচয় তারিখের পরে এই প্রপার্টি ফেরত দেওয়া হবে না। - এটি
liveStreamরিসোর্সেরisDefaultStreamপ্রপার্টির মান পরীক্ষা করে। অবচয় তারিখের পরে এই প্রপার্টিটি ফেরত দেওয়া হবে না। - এটি
liveBroadcasts.listপদ্ধতিকে কল করে এবংbroadcastTypeপ্যারামিটারের মানকেpersistentঅথবাallএ সেট করে। এই পরিবর্তনগুলির অংশ হিসাবে এই প্যারামিটারটি অবচিত হবে। অবচিতির তারিখ অনুসারে:- যদি
broadcastTypeপ্যারামিটারের মানpersistentথাকে, তাহলেliveBroadcasts.listপদ্ধতি কোনও ফলাফল দেবে না। - যদি
broadcastTypeপ্যারামিটারের মানallহয়, তাহলেliveBroadcasts.listপদ্ধতিটি সেই সময়ের আগে বিদ্যমান স্থায়ী সম্প্রচারগুলি ফেরত দেবে না।
- যদি
পটভূমি হিসেবে, গত কয়েক বছর ধরে, ইউটিউব যখন কোনও চ্যানেল লাইভ স্ট্রিমিংয়ের জন্য সক্ষম করা হয়েছিল তখন স্বয়ংক্রিয়ভাবে একটি ডিফল্ট স্ট্রিম এবং একটি ডিফল্ট সম্প্রচার তৈরি করেছে। ডিফল্ট স্ট্রিমটি অনির্দিষ্টকালের জন্য বিদ্যমান ছিল, এর সাথে কোনও শুরু বা শেষ সময় যুক্ত ছিল না এবং এটি মুছে ফেলা যেত না। একইভাবে, ডিফল্ট সম্প্রচারকে স্থায়ী হিসাবে বিবেচনা করা হত। এটি সর্বদা বিদ্যমান ছিল এবং কোনও নির্দিষ্ট ইভেন্টের সাথে আবদ্ধ ছিল না।
অবচয় তারিখ অনুসারে:
- YouTube আর ডিফল্ট স্ট্রিম এবং সম্প্রচার তৈরি করবে না। ডিফল্ট রিসোর্সের উপর নির্ভর করার পরিবর্তে, API ক্লায়েন্টদের
liveBroadcastএবংliveStreamরিসোর্স তৈরি এবং পরিচালনা করতে এবং সেই রিসোর্সগুলিকে একসাথে আবদ্ধ করতে সক্ষম হতে হবে। - যদি কোনও চ্যানেলের ডিফল্ট সম্প্রচার এবং ডিফল্ট স্ট্রিম সক্রিয়ভাবে লাইভ থাকে, অর্থাৎ বন্ধ করার সময় চ্যানেলটি লাইভ সম্প্রচারের জন্য এগুলি ব্যবহার করছে, তাহলে চলমান সম্প্রচার প্রভাবিত হবে না। তবে, সেই সম্প্রচার শেষ হওয়ার পরে, চ্যানেলটি আর ডিফল্ট সম্প্রচার এবং ডিফল্ট স্ট্রিম ব্যবহার করতে পারবে না।
- যদি কোনও চ্যানেলের ডিফল্ট সম্প্রচার এবং ডিফল্ট স্ট্রিম সক্রিয়ভাবে লাইভ না হয়, তাহলে বন্ধ করার পরে, YouTube ভিডিও সম্প্রচারের জন্য সেই সংস্থানগুলি ব্যবহার করার প্রচেষ্টা উপেক্ষা করবে।
যদি আপনার আবেদন প্রভাবিত হয়, তাহলে অনুগ্রহ করে নিম্নলিখিত নথিগুলি দেখুন, যা আপনাকে আপনার আবেদন আপডেট করতে সাহায্য করবে যাতে এই পরিবর্তনের পরেও এটি প্রত্যাশা অনুযায়ী কাজ করে:
- একটি নতুন মাইগ্রেশন গাইডে বর্তমানে ডিফল্ট ব্রডকাস্ট এবং স্ট্রিম ব্যবহারকারী API ক্লায়েন্টগুলিতে ডেভেলপারদের কী কী পদক্ষেপ নিতে হতে পারে তা ব্যাখ্যা করার চেষ্টা করা হয়েছে।
- "দ্য লাইফ অফ আ ব্রডকাস্ট গাইড" আপনাকে ধাপে ধাপে একটি প্রক্রিয়ার মধ্য দিয়ে নিয়ে যাবে যা YouTube-এ একটি লাইভ ইভেন্ট কীভাবে তৈরি এবং পরিচালনা করতে হয় তা ব্যাখ্যা করে। প্রতিটি ধাপে API কল বা একটি নির্দিষ্ট কাজ সম্পন্ন করার জন্য আপনাকে কী কী করতে হবে তা ব্যাখ্যা করা হয়েছে এবং YouTube যখন ডিফল্ট স্ট্রিম এবং সম্প্রচার সমর্থন করা বন্ধ করে দেয় তখন আপনার অ্যাপ্লিকেশনটিকে সেই প্রক্রিয়াটি অনুসরণ করতে হবে।
- এটি
৩১ মার্চ, ২০২০
দ্রষ্টব্য: এটি একটি অবচয় রোধের ঘোষণা।
sponsor রিসোর্স এবং sponsors.list পদ্ধতিটি বাতিল করা হয়েছে এবং member রিসোর্স এবং members.list পদ্ধতি দ্বারা প্রতিস্থাপিত হয়েছে।
৩০শে সেপ্টেম্বর, ২০২০ তারিখে বা তার পরে sponsors.list পদ্ধতিটি আর সমর্থিত হবে না। API ক্লায়েন্টদের members.list পদ্ধতিটি ব্যবহার করার জন্য sponsors.list পদ্ধতিতে কল আপডেট করা উচিত। নতুন রিসোর্স সম্পর্কে আরও তথ্যের জন্য অনুগ্রহ করে YouTube ডেটা API সংশোধন ইতিহাস দেখুন।
১১ মার্চ, ২০২০
প্রাথমিক এবং ব্যাকআপ ইনজেশন URL তৈরি করার সময় file= প্যারামিটার মান সম্পূর্ণ করার জন্য একটি এনকোডারের ব্যবহার করা উচিত এমন প্রক্রিয়াটি স্পষ্ট করার জন্য HLS নির্দেশিকার মাধ্যমে লাইভ YouTube কন্টেন্ট সরবরাহের শেষ বিন্দু বিভাগটি আপডেট করা হয়েছে।
৪ ফেব্রুয়ারী, ২০২০
"HLS এর মাধ্যমে লাইভ YouTube কন্টেন্ট বিতরণ" নির্দেশিকাটি আপডেট করা হয়েছে যাতে উল্লেখ করা হয়েছে যে DELETE অনুরোধগুলি ঐচ্ছিক এবং YouTube এর HLS এন্ডপয়েন্ট সেগুলি উপেক্ষা করে। পারফরম্যান্সের কারণে, YouTube ক্লায়েন্টদের DELETE অনুরোধগুলি না পাঠানোর পরামর্শ দেয়।
১০ জানুয়ারী, ২০২০
API এখন শিশু-নির্দেশিত কন্টেন্ট শনাক্ত করার ক্ষমতা সমর্থন করে, যাকে YouTube "বাচ্চাদের জন্য তৈরি" বলে। YouTube সহায়তা কেন্দ্রে "বাচ্চাদের জন্য তৈরি" কন্টেন্ট সম্পর্কে আরও জানুন ।
-
liveBroadcastরিসোর্স দুটি নতুন বৈশিষ্ট্য সমর্থন করে যা কন্টেন্ট নির্মাতা এবং দর্শকদের "বাচ্চাদের জন্য তৈরি" কন্টেন্ট সনাক্ত করতে সক্ষম করে:-
selfDeclaredMadeForKidsপ্রপার্টি কন্টেন্ট ক্রিয়েটরদের লাইভ সম্প্রচার শিশু-নির্দেশিত কন্টেন্ট কিনা তা নির্দিষ্ট করতে সক্ষম করে।liveBroadcasts.insertপদ্ধতির মাধ্যমে সম্প্রচার তৈরি করার সময় এই প্রপার্টি সেট করা যেতে পারে। মনে রাখবেন যে এই প্রপার্টি শুধুমাত্র সেই API প্রতিক্রিয়াগুলিতে অন্তর্ভুক্ত থাকে যেখানেliveBroadcastরিসোর্স থাকে যদি চ্যানেলের মালিক API অনুরোধটি অনুমোদন করেন। -
madeForKidsপ্রপার্টি যেকোনো API ব্যবহারকারীকে একটি সম্প্রচারের "বাচ্চাদের জন্য তৈরি" স্ট্যাটাস পুনরুদ্ধার করতে সক্ষম করে। উদাহরণস্বরূপ,selfDeclaredMadeForKidsMadeForKids প্রপার্টির মানের উপর ভিত্তি করে স্ট্যাটাস নির্ধারণ করা হতে পারে। আপনার চ্যানেল, ভিডিও বা সম্প্রচারের জন্য দর্শক নির্ধারণ সম্পর্কে আরও তথ্যের জন্য YouTube সহায়তা কেন্দ্র দেখুন।
-
- YouTube ডেটা API-তে,
channelরিসোর্সটি নতুনselfDeclaredMadeForKidsএবংmadeForKidsবৈশিষ্ট্যগুলিকেও সমর্থন করে।
আমরা YouTube API পরিষেবার পরিষেবার শর্তাবলী এবং ডেভেলপার নীতিগুলিও আপডেট করেছি। আরও তথ্যের জন্য দয়া করে YouTube API পরিষেবার পরিষেবার শর্তাবলী - সংশোধন ইতিহাস দেখুন। YouTube API পরিষেবার পরিষেবার শর্তাবলী এবং ডেভেলপার নীতিগুলিতে পরিবর্তনগুলি 10 জানুয়ারী, 2020 প্যাসিফিক টাইম থেকে কার্যকর হবে।
২০ আগস্ট, ২০১৯
"HLS এর মাধ্যমে লাইভ ইউটিউব কন্টেন্ট সরবরাহ করা" নির্দেশিকার প্রয়োজনীয়তা বিভাগটি দুটি পরিবর্তন সহ আপডেট করা হয়েছে:
- এটি ব্যাখ্যা করে যে প্রতিটি মিডিয়া প্লেলিস্টে স্বীকৃত বিভাগ এবং অসামান্য বিভাগ উভয়ই অন্তর্ভুক্ত করা একটি সর্বোত্তম অনুশীলন। এই অনুশীলনের ফলে সার্ভার সাইডে কোনও মিডিয়া প্লেলিস্ট হারিয়ে গেলে কোনও বিভাগ বাদ পড়ার সম্ভাবনা কম থাকে। উদাহরণস্বরূপ, আপনি প্রতিটি মিডিয়া প্লেলিস্টে সর্বাধিক দুটি স্বীকৃত বিভাগ এবং সর্বাধিক পাঁচটি অসামান্য বিভাগ অন্তর্ভুক্ত করতে পারেন।
- এখন প্রতিটি মিডিয়া বিভাগের জন্য একটি মিডিয়া প্লেলিস্ট পাঠানো বাধ্যতামূলক। এটি সার্ভারকে মিডিয়া প্লেলিস্ট হারিয়ে গেলে দ্রুত পুনরুদ্ধার করতে সক্ষম করে। এই পদ্ধতিটি পূর্বে সুপারিশ হিসাবে তালিকাভুক্ত ছিল।
২৮ জুন, ২০১৯
YouTube এখন HLS ইনজেশন সমর্থন করে। সেই অনুযায়ী, liveStream রিসোর্সের ingestionType প্রপার্টি HLS ব্যবহার করে YouTube-এ ইনজেশন করা স্ট্রিমগুলি সনাক্ত করতে নতুন মান hls সমর্থন করে।
নতুন "HLS এর মাধ্যমে লাইভ YouTube কন্টেন্ট ডেলিভারিং " নির্দেশিকাটি HLS ব্যবহার করে এনকোডার থেকে YouTube-এ লাইভ কন্টেন্ট স্ট্রিম করার নির্দেশিকা প্রদান করে। এই নির্দেশিকার লক্ষ্য হল এনকোডার বিক্রেতাদের তাদের পণ্যগুলিতে HLS ডেলিভারি সহায়তা যোগ করতে সহায়তা করা।
৪ এপ্রিল, ২০১৯
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
API রেফারেন্স ডকুমেন্টেশন আপডেট করা হয়েছে যাতে প্রতিটি পদ্ধতির সাধারণ ব্যবহারের ক্ষেত্রে আরও ভালোভাবে ব্যাখ্যা করা যায় এবং APIs Explorer উইজেটের মাধ্যমে গতিশীল, উচ্চ-মানের কোড নমুনা প্রদান করা যায়। উদাহরণের জন্য
liveBroadcasts.listপদ্ধতির ডকুমেন্টেশন দেখুন। এখন পৃষ্ঠাগুলিতে দুটি নতুন উপাদান রয়েছে যা API পদ্ধতি বর্ণনা করে:APIs Explorer উইজেট আপনাকে অনুমোদনের স্কোপ নির্বাচন করতে, নমুনা প্যারামিটার এবং সম্পত্তির মান প্রবেশ করতে এবং তারপর প্রকৃত API অনুরোধ পাঠাতে এবং প্রকৃত API প্রতিক্রিয়া দেখতে দেয়। উইজেটটি একটি পূর্ণস্ক্রিন ভিউও অফার করে যা সম্পূর্ণ কোড নমুনা দেখায়, যা আপনার প্রবেশ করানো স্কোপ এবং মানগুলি ব্যবহার করার জন্য গতিশীলভাবে আপডেট হয়।
সাধারণ ব্যবহারের ক্ষেত্রে বিভাগটি পৃষ্ঠায় বর্ণিত পদ্ধতির জন্য এক বা একাধিক সাধারণ ব্যবহারের ক্ষেত্রে বর্ণনা করে। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট সম্প্রচার সম্পর্কে তথ্য পুনরুদ্ধার করতে বা বর্তমান ব্যবহারকারীর সম্প্রচার সম্পর্কে তথ্য পুনরুদ্ধার করতে
liveBroadcasts.listপদ্ধতিতে কল করতে পারেন।আপনি সেই বিভাগের লিঙ্কগুলি ব্যবহার করে আপনার ব্যবহারের ক্ষেত্রে নমুনা মান সহ APIs Explorer পূরণ করতে পারেন অথবা ইতিমধ্যেই পূরণ করা মান সহ পূর্ণস্ক্রিন APIs Explorer খুলতে পারেন। এই পরিবর্তনগুলির লক্ষ্য হল আপনার জন্য এমন কোড নমুনাগুলি দেখা সহজ করা যা আপনার নিজস্ব অ্যাপ্লিকেশনে প্রয়োগ করার চেষ্টা করা ব্যবহারের ক্ষেত্রে সরাসরি প্রযোজ্য।
কোড নমুনা বর্তমানে জাভা, জাভাস্ক্রিপ্ট, পিএইচপি, পাইথন এবং কার্লের জন্য সমর্থিত।
কোড নমুনা পৃষ্ঠাটিতে একটি নতুন UI রয়েছে যা উপরে বর্ণিত সমস্ত বৈশিষ্ট্য অফার করে। এই টুলটি ব্যবহার করে, আপনি বিভিন্ন পদ্ধতির ব্যবহারের কেসগুলি অন্বেষণ করতে পারেন, API এক্সপ্লোরারে মান লোড করতে পারেন এবং জাভা, জাভাস্ক্রিপ্ট, PHP এবং পাইথনে কোড নমুনা পেতে পূর্ণস্ক্রিন API এক্সপ্লোরার খুলতে পারেন।
এই পরিবর্তনের সাথে সাথে, জাভা, পিএইচপি এবং পাইথনের জন্য পূর্বে উপলব্ধ কোড নমুনা তালিকাভুক্ত পৃষ্ঠাগুলি সরানো হয়েছে।
২৫ ফেব্রুয়ারী, ২০১৯
liveChatMessage এবং superChatEvent রিসোর্সের ডকুমেন্টেশন আপডেট করা হয়েছে যাতে দেখা যায় যে, দুটি রিসোর্সেই এখন সুপার স্টিকার সম্পর্কে তথ্য থাকতে পারে। সুপার স্টিকার হল এক ধরণের সুপার চ্যাট মেসেজ যা একটি ছবি প্রদর্শন করে। অন্যান্য সুপার চ্যাটের মতো, ইউটিউব লাইভ স্ট্রিম চলাকালীন একজন ভক্ত একটি সুপার স্টিকার মেসেজ কিনে নেন।
- একটি
liveChatMessageরিসোর্সে,snippet.typeপ্রপার্টিটি এখনsuperStickerEventএ সেট করা আছে যা নির্দেশ করে যে রিসোর্সে একটি সুপার স্টিকার সম্পর্কে তথ্য রয়েছে। সেই ক্ষেত্রে, রিসোর্সেsnippet.superStickerDetailsঅবজেক্টও থাকে, যাতে সুপার স্টিকার সম্পর্কে অতিরিক্ত তথ্য থাকে। - একটি
superChatEventরিসোর্সে, বুলিয়ানsnippet.isSuperStickerEventনির্দেশ করে যে সুপার চ্যাট বার্তাটিও একটি সুপার স্টিকার কিনা। যদি তাই হয়, তাহলেsnippet.superStickerMetadataঅবজেক্টে সুপার স্টিকার সম্পর্কে অতিরিক্ত তথ্য রয়েছে।
৫ এপ্রিল, ২০১৮
superChatEvents.list পদ্ধতির বর্ণনা আপডেট করা হয়েছে যাতে API প্রতিক্রিয়াতে আর fanFundingEvents নেই, যা ২০১৭ সালের প্রথম দিকে বন্ধ করে দেওয়া হয়েছিল।
৩ এপ্রিল, ২০১৭
নতুন জাভা কোড নমুনা যোগ করা হয়েছে যা দেখায় কিভাবে লাইভ চ্যাট বার্তা তালিকাভুক্ত করতে , সন্নিবেশ করতে এবং মুছে ফেলতে হয় । নমুনাগুলি নিম্নলিখিত পদ্ধতিগুলিকে কল করে:
১৩ ফেব্রুয়ারী, ২০১৭
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
liveCuepoints.insertপদ্ধতিটি আপডেট করা হয়েছে যাতেonBehalfOfContentOwnerপ্যারামিটারটি বর্তমানে প্রয়োজনীয় বলে প্রতিফলিত হয়। এছাড়াও, পদ্ধতির বিবরণ আপডেট করা হয়েছে যাতে মনে রাখা যায় যে সেই পদ্ধতিতে কলগুলি অবশ্যই YouTube কন্টেন্ট মালিকের সাথে সম্পর্কিত কোনও অ্যাকাউন্ট দ্বারা অনুমোদিত হতে হবে।
৯ ফেব্রুয়ারী, ২০১৭
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
superChatEvents.listপদ্ধতির নতুনhlপ্যারামিটার আপনাকে নির্দিষ্ট করতে দেয় যেsnippet.displayStringপ্রোপার্টির মান একটি নির্দিষ্ট ভাষার নিয়ম অনুসারে ফর্ম্যাট করা উচিত। সেই প্রোপার্টির সংজ্ঞাও সেই অনুযায়ী আপডেট করা হয়েছে।প্যারামিটার মানটি অবশ্যই
i18nLanguages.listপদ্ধতি দ্বারা প্রদত্ত তালিকায় অন্তর্ভুক্ত একটি ভাষা কোড হতে হবে। ডিফল্ট মান হলen, যার অর্থ হল ডিফল্ট আচরণ হল ডিসপ্লে স্ট্রিংগুলিকে ইংরেজিতে যেভাবে ব্যবহার করা হবে সেভাবে ফর্ম্যাট করা। উদাহরণস্বরূপ, ডিফল্টরূপে, একটি স্ট্রিং$1.00এর পরিবর্তে$1,00হিসাবে ফর্ম্যাট করা হয়।
১ ফেব্রুয়ারী, ২০১৭
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
নতুন
superChatEventরিসোর্সটি ইউটিউব লাইভ স্ট্রিম চলাকালীন একজন ভক্তের কেনা একটি সুপার চ্যাট বার্তা উপস্থাপন করে। ইউটিউব লাইভ চ্যাট স্ট্রিমে, সুপার চ্যাট দুটি উপায়ে অন্যান্য বার্তা থেকে আলাদা হয়:- সুপার চ্যাটগুলিকে একটি রঙ দিয়ে হাইলাইট করা হয়।
- সুপার চ্যাটগুলি একটি নির্দিষ্ট সময়ের জন্য টিকারে পিন করা থাকে।
সুপার চ্যাটের রঙ, টিকারে এটি কতক্ষণ পিন করা থাকে এবং সর্বাধিক বার্তার দৈর্ঘ্য সবই ক্রয়ের পরিমাণের উপর নির্ভর করে। সুপার চ্যাট সম্পর্কে আরও তথ্য YouTube সহায়তা কেন্দ্রে রয়েছে।
API একটি চ্যানেলের পূর্ববর্তী 30 দিনের লাইভ স্ট্রিমগুলির জন্য সুপার চ্যাট ইভেন্টগুলি তালিকাভুক্ত করার একটি পদ্ধতি সমর্থন করে। এই পদ্ধতিটি চ্যানেলের শেষ লাইভ স্ট্রিম থেকে ফ্যান ফান্ডিং ইভেন্টগুলি (
fanFundingEvents) সম্পর্কে ডেটাও ফেরত দেয়।
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
snippet.typeপ্রপার্টি এখনsuperChatEventমান সমর্থন করে, যা নির্দেশ করে যে রিসোর্সটি একটি সুপার চ্যাট বর্ণনা করে।এছাড়াও,
liveChatMessageরিসোর্সের নতুনsnippet.superChatDetailsপ্রপার্টি এবং এর সন্তানদের মধ্যে সুপার চ্যাট ইভেন্ট সম্পর্কে তথ্য রয়েছে।liveStreamরিসোর্সেরcdn.resolutionপ্রপার্টি এখন2160pমান সমর্থন করে।
নতুন এবং আপডেট করা ত্রুটি
API নিম্নলিখিত নতুন ত্রুটিগুলিকে সমর্থন করে:
ত্রুটির বিবরণ liveBroadcasts.insert,liveBroadcasts.updateliveBroadcasts.insertএবংliveBroadcasts.updateপদ্ধতিগুলি400(Bad Request) ত্রুটি প্রদান করে যা নির্দেশ করে যেliveBroadcastরিসোর্সে সন্নিবেশিত বা আপডেট করা হচ্ছেcontentDetails.enableEmbedসম্পত্তি অথবাcontentDetails.projectionসম্পত্তির জন্য একটি অবৈধ মান রয়েছে। দুটি নতুন ত্রুটির কারণ যথাক্রমেinvalidEmbedSettingএবংinvalidProjection।
১২ জানুয়ারী, ২০১৭
দ্রষ্টব্য: এটি একটি অবচয় রোধের ঘোষণা।
নতুন সুপার চ্যাট বৈশিষ্ট্য প্রকাশের সাথে সাথে, YouTube ফ্যান ফান্ডিং বৈশিষ্ট্যটি বন্ধ করে দিয়েছে এবং ফ্যান ফান্ডিং API ২৮শে ফেব্রুয়ারী, ২০১৭ তারিখে বন্ধ করে দেওয়া হবে। সেই তারিখ থেকে:
-
liveChatMessages.listপদ্ধতিতে আরsnippet.typefanFundingEventসহ বার্তাগুলি ফেরত দেওয়া হবে না। একইভাবে,liveChatMessageরিসোর্সে আরsnippet.fanFundingEventDetailsঅবজেক্ট থাকবে না। -
fanFundingEvents.listপদ্ধতি আর ডেটা ফেরত দেবে না।
১১ আগস্ট, ২০১৬
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন প্রকাশিত YouTube API পরিষেবার পরিষেবার শর্তাবলী ("আপডেট করা শর্তাবলী"), যা YouTube Engineering and Developers Blog এ বিস্তারিতভাবে আলোচনা করা হয়েছে, বর্তমান পরিষেবার শর্তাবলীতে প্রচুর আপডেট প্রদান করে। আপডেট করা শর্তাবলী ছাড়াও, যা 10 ফেব্রুয়ারী, 2017 থেকে কার্যকর হবে, এই আপডেটে ডেভেলপারদের অনুসরণ করা নীতিগুলি ব্যাখ্যা করতে সহায়তা করার জন্য বেশ কয়েকটি সহায়ক নথি অন্তর্ভুক্ত রয়েছে।
আপডেট করা শর্তাবলীর পুনর্বিবেচনার ইতিহাসে নতুন নথির সম্পূর্ণ সেট বর্ণনা করা আছে। এছাড়াও, আপডেট করা শর্তাবলী বা সেই সমর্থনকারী নথিতে ভবিষ্যতের পরিবর্তনগুলিও সেই পুনর্বিবেচনার ইতিহাসে ব্যাখ্যা করা হবে। আপনি সেই নথির একটি লিঙ্ক থেকে সেই পুনর্বিবেচনার ইতিহাসে পরিবর্তনগুলি তালিকাভুক্ত RSS ফিডে সাবস্ক্রাইব করতে পারেন।
২০ মে, ২০১৬
YouTube এখন DASH ইনজেশন সমর্থন করে। সেই অনুযায়ী, liveStream রিসোর্সের ingestionType প্রপার্টি DASH ব্যবহার করে YouTube-এ ইনজেশন করা স্ট্রিমগুলি সনাক্ত করতে নতুন মান dash সমর্থন করে।
নতুন ডেলিভারিং লাইভ ইউটিউব কন্টেন্ট ভিয়া ড্যাশ নির্দেশিকাটিতে এনকোডার থেকে ইউটিউবে লাইভ ডেটা স্ট্রিম করার জন্য ড্যাশ ডেলিভারি ফর্ম্যাট ব্যবহারের নির্দেশিকা দেওয়া হয়েছে। এটি এনকোডার বিক্রেতাদের তাদের পণ্যগুলিতে ড্যাশ ডেলিভারি সহায়তা যোগ করতে সাহায্য করার উদ্দেশ্যে তৈরি করা হয়েছে।
১৮ এপ্রিল, ২০১৬
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
-
liveStreamরিসোর্স আপডেটইউটিউব এখন প্রতি সেকেন্ডে 30 বা 60 ফ্রেমে 1440p রেজোলিউশনের স্ট্রিম সমর্থন করে।
এছাড়াও,
liveStreamরিসোর্সে ইনবাউন্ড ভিডিও ডেটার ফ্রেম রেট এবং রেজোলিউশন নির্দিষ্ট করার জন্য নতুন বৈশিষ্ট্য রয়েছে:বৈশিষ্ট্য cdn.frameRateইনবাউন্ড ভিডিও ডেটার ফ্রেম রেট। বৈধ মান হল 30fpsএবং60fps।cdn.resolutionইনবাউন্ড ভিডিও ডেটার রেজোলিউশন। বৈধ বৈশিষ্ট্যের মান হল: 1440p,1080p,720p,480p,360p, এবং240p।liveStreamরিসোর্সেরcdn.frameRateএবংcdn.resolutionপ্রপার্টি প্রবর্তনের সাথে সাথে, রিসোর্সেরcdn.formatএখন অবচিত।cdn.formatপ্রপার্টি রেজোলিউশন এবং ফ্রেম রেটকে একটি একক মানের মধ্যে নির্দিষ্ট করে।আমরা আপনাকে নতুন সমর্থিত ক্ষেত্রগুলিতে স্থানান্তর করার জন্য উৎসাহিত করছি। ইতিমধ্যে,
cdn.formatকাজ চালিয়ে যাচ্ছে। এছাড়াও, লাইভ স্ট্রিম সন্নিবেশ করার অনুরোধগুলি বর্তমানে সফল হয় যতক্ষণ না আপনিcdn.formatসম্পত্তি অথবাcdn.frameRateএবংcdn.resolutionবৈশিষ্ট্যের জন্য মান নির্দিষ্ট করেন। আপনি যদি তিনটি বৈশিষ্ট্যের জন্য মান প্রদান করেন, তাহলে মানগুলি একমত না হলে API একটি ত্রুটি ফেরত দিতে পারে।মনে রাখবেন যে
cdn.formatপ্রপার্টিটি বন্ধ করা হলেও, এটি এখন দুটি নতুন মান,1440pএবং1440p_hfrসমর্থন করে, যা প্রতি সেকেন্ডে 30 বা 60 ফ্রেমে 1440p স্ট্রিমগুলির জন্য API এর সমর্থন প্রতিফলিত করে।
-
liveBroadcastরিসোর্স আপডেটliveBroadcastরিসোর্সে নিম্নলিখিত নতুন বৈশিষ্ট্য রয়েছে:বৈশিষ্ট্য contentDetails.boundStreamLastUpdateTimeMsসম্প্রচারের contentDetails.boundStreamIdপ্রপার্টি দ্বারা উল্লেখিত লাইভ স্ট্রিমটি শেষ আপডেট করা তারিখ এবং সময়।contentDetails.projectionসম্প্রচারের প্রক্ষেপণ বিন্যাস। সম্পত্তির ডিফল্ট মান হল rectangular। সম্পত্তির জন্য বৈধ মান হল360এবংrectangular।liveBroadcastরিসোর্সেরstatistics.totalChatCountপ্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে প্রপার্টির মান শুধুমাত্র তখনই দেখা যায় যদি ব্রডকাস্টে কমপক্ষে একটি চ্যাট মেসেজ থাকে।
-
liveChatMessageরিসোর্স আপডেটsnippet.typeপ্রপার্টি দুটি নতুন মান সমর্থন করে -messageDeletedEventএবংuserBannedEvent- যা নিম্নলিখিত বুলেট পয়েন্টে বর্ণিত নতুন বৈশিষ্ট্যের সাথে সঙ্গতিপূর্ণ।snippet.authorChannelIdপ্রপার্টির সংজ্ঞাও আপডেট করা হয়েছে যাতে এই নতুন মেসেজ টাইপের জন্য প্রপার্টির মান কী সনাক্ত করে তা ব্যাখ্যা করা যায়।liveChatMessageরিসোর্সে নিম্নলিখিত নতুন বৈশিষ্ট্য রয়েছে:বৈশিষ্ট্য snippet.messageDeletedDetailsএই অবজেক্টটিতে একটি চ্যাট মডারেটর দ্বারা মুছে ফেলা বার্তা সম্পর্কে তথ্য রয়েছে। snippet.typeপ্রোপার্টির মানmessageDeletedEventহলেই অবজেক্টটি উপস্থিত থাকে।snippet.userBannedDetailsএই অবজেক্টে এমন একজন ব্যবহারকারীর তথ্য রয়েছে যাকে চ্যাটে অংশগ্রহণ থেকে নিষিদ্ধ করা হয়েছে। অবজেক্টটিতে নিষেধাজ্ঞা সম্পর্কেও তথ্য রয়েছে, যেমন নিষেধাজ্ঞা স্থায়ী নাকি অস্থায়ী। যদি নিষেধাজ্ঞা অস্থায়ী হয়, তাহলে অবজেক্টের একটি বৈশিষ্ট্য নিষেধাজ্ঞার সময়কাল নির্দিষ্ট করে।
এই অবজেক্টটি কেবল তখনই উপস্থিত থাকে যদিsnippet.typeপ্রপার্টির মানuserBannedEventহয়।
-
নতুন এবং আপডেট করা ত্রুটি
API নিম্নলিখিত নতুন ত্রুটিগুলিকে সমর্থন করে:
ত্রুটির বিবরণ liveBroadcasts.bindliveBroadcasts.bindপদ্ধতিটি একটি403(Forbidden) ত্রুটি প্রদান করে যা নির্দেশ করে যে ব্যবহারকারী একটি নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি অনুরোধ পাঠিয়েছেন। ত্রুটির কারণ হলuserRequestsExceedRateLimit।
liveBroadcasts.insertএবংliveBroadcasts.updateপদ্ধতিগুলি ইতিমধ্যেই একই ত্রুটি সমর্থন করে।liveStreams.insertliveStreams.insertপদ্ধতি চারটি নতুন400(Bad Request) ত্রুটি সমর্থন করে যা অনুরোধটি যেliveStreamরিসোর্সটি সন্নিবেশ করার চেষ্টা করেছিল তাতে একটি অবৈধ সম্পত্তির মান সনাক্ত করে। নিম্নলিখিত তালিকাটি ত্রুটির কারণ এবং সেগুলি যে বৈশিষ্ট্যগুলির সাথে সম্পর্কিত তা সনাক্ত করে:-
invalidFormat:cdn.format -
invalidFrameRate:cdn.frameRate -
invalidIngestionType:cdn.ingestionType -
invalidResolution:cdn.resolution
liveStreams.insertliveStreams.insertপদ্ধতি দুটি নতুন400(Bad Request) ত্রুটি সমর্থন করে, যার প্রতিটি ইঙ্গিত দেয় যে অনুরোধটি যেliveStreamরিসোর্সটি সন্নিবেশ করার চেষ্টা করেছিল তাতে একটি প্রয়োজনীয় মান উপস্থিত নেই। নিম্নলিখিত তালিকাটি ত্রুটির কারণ এবং সেগুলি যে বৈশিষ্ট্যগুলির সাথে সম্পর্কিত তা চিহ্নিত করে:-
frameRateRequired:cdn.frameRate -
resolutionRequired:cdn.resolution
liveStreamরিসোর্স সন্নিবেশ করান, তখন আপনাকেcdn.formatপ্রপার্টি অথবাcdn.frameRateএবংcdn.resolutionপ্রপার্টির জন্য একটি মান নির্দিষ্ট করতে হবে।- যদি আপনি তিনটি বৈশিষ্ট্যের যেকোনো একটির জন্য একটি মান নির্দিষ্ট না করেন, তাহলে API একটি
formatRequiredত্রুটি প্রদান করে। - যদি আপনি
cdn.resolutionএর জন্য একটি মান নির্দিষ্ট করেন কিন্তুcdn.frameRateজন্য মান উল্লেখ করেন, তাহলে API একটিframeRateRequiredত্রুটি প্রদান করে। - যদি আপনি
cdn.frameRateজন্য একটি মান নির্দিষ্ট করেন কিন্তুcdn.resolutionজন্য একটি মান উল্লেখ করেন, তাহলে API একটিresolutionRequiredত্রুটি প্রদান করে।
liveStreams.updateযদি অনুরোধটি নিম্নলিখিত অ-পরিবর্তনীয় বৈশিষ্ট্যগুলির মান পরিবর্তন করার চেষ্টা করে, তাহলে liveStreams.updateপদ্ধতিটি একটি403(Forbidden) ত্রুটি প্রদান করে:-
cdn.format -
cdn.frameRate -
cdn.ingestionType -
cdn.resolution
reasonহলliveStreamModificationNotAllowed।-
১৮ ডিসেম্বর, ২০১৫
ইউরোপীয় ইউনিয়ন (EU) আইন অনুসারে, EU-এর শেষ ব্যবহারকারীদের নির্দিষ্ট কিছু তথ্য প্রকাশ করতে হবে এবং তাদের কাছ থেকে সম্মতি নিতে হবে। অতএব, ইউরোপীয় ইউনিয়নের শেষ ব্যবহারকারীদের জন্য, আপনাকে EU ব্যবহারকারী সম্মতি নীতি মেনে চলতে হবে। আমরা আমাদের YouTube API পরিষেবার শর্তাবলীতে এই প্রয়োজনীয়তার একটি বিজ্ঞপ্তি যুক্ত করেছি।
১৭ ডিসেম্বর, ২০১৫
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
লাইভ সম্প্রচারের জন্য চ্যাট কার্যকারিতা সমর্থন করার জন্য API বেশ কয়েকটি নতুন সংস্থান সমর্থন করে। YouTube সক্রিয় লাইভ সম্প্রচারের সময় লাইভ চ্যাট কার্যকারিতা সমর্থন করে এবং এই সংস্থানগুলি এবং তাদের পদ্ধতিগুলি চ্যাট বার্তা পুনরুদ্ধারের পাশাপাশি চ্যাটের জন্য প্রশাসনিক কার্যকারিতা সমর্থন করে।
রিসোর্স liveChatMessageএই রিসোর্সটি একটি YouTube লাইভ চ্যাটে একটি বার্তা উপস্থাপন করে। YouTube বিভিন্ন ধরণের বার্তা সমর্থন করে, যার মধ্যে রয়েছে টেক্সট বার্তা এবং ফ্যান ফান্ডিং ইভেন্ট। কিছু বার্তার ধরণ চ্যাটের একটি নির্দিষ্ট পর্যায় চিহ্নিত করে, যেমন স্পনসর-কেবল সময়ের শুরু বা চ্যাটের শেষ। API লাইভ চ্যাট বার্তাগুলি তালিকাভুক্ত, সন্নিবেশ করা এবং মুছে ফেলার পদ্ধতিগুলিকে সমর্থন করে। liveChatModeratorsএই রিসোর্সটি একজন চ্যাট মডারেটরকে শনাক্ত করে। মডারেটররা কিছু প্রশাসনিক কাজ সম্পাদন করতে পারে, যেমন চ্যাট থেকে ব্যবহারকারীদের নিষিদ্ধ করা বা বার্তাগুলি সরানো। API লাইভ চ্যাট মডারেটরদের তালিকাভুক্ত, সন্নিবেশ করা এবং মুছে ফেলার পদ্ধতিগুলিকে সমর্থন করে। liveChatBansএই রিসোর্সটি এমন একজন ব্যবহারকারীকে শনাক্ত করে যাকে একটি নির্দিষ্ট লাইভ চ্যাটে বার্তা পোস্ট করা থেকে নিষিদ্ধ করা হয়েছে। নিষেধাজ্ঞাগুলি অস্থায়ী বা স্থায়ী হতে পারে। API লাইভ চ্যাট নিষেধাজ্ঞা সন্নিবেশ এবং মুছে ফেলার পদ্ধতিগুলিকে সমর্থন করে। fanFundingEventsএই রিসোর্সটি একটি YouTube চ্যানেলে একটি ফ্যান ফান্ডিং ইভেন্টের প্রতিনিধিত্ব করে। ফ্যান ফান্ডিং দর্শকদের স্বেচ্ছায় YouTube ক্রিয়েটরদের এককালীন আর্থিক সহায়তা প্রদানের একটি উপায় প্রদান করে।
API এরfanFundingEvents.listপদ্ধতিতে একটি চ্যানেলের ফ্যান ফান্ডিং ইভেন্ট তালিকাভুক্ত করা হয়। চ্যানেলের মালিকানাধীন লাইভ সম্প্রচারের সময় লাইভ চ্যাটের মাধ্যমে শুরু হওয়া ফ্যান ফান্ডিং ইভেন্টগুলি সম্প্রচারের লাইভ চ্যাটে একটিfanFundingEventবার্তাও ট্রিগার করে।
YouTube সহায়তা কেন্দ্রে অনুরাগীর তহবিল সম্পর্কে আরও জানুন।sponsorssponsorরিসোর্সটি একটি YouTube চ্যানেলের স্পনসরকে শনাক্ত করে। একজন স্পনসর একটি চ্যানেলকে মাসিক ফি প্রদান করে। চ্যানেলের লাইভ চ্যাটে স্পনসরের বার্তাগুলির পাশে একটি ব্যাজ প্রদর্শিত হয় এবং স্পনসররা চ্যানেলের স্পনসরদের জন্য বিশেষভাবে লাইভ চ্যাটে অংশগ্রহণ করতে পারে, যদি তা ঘটে।
API-এরsponsors.listপদ্ধতিতে একটি চ্যানেলের স্পনসরদের তালিকা দেওয়া হয়। যখন ব্যবহারকারীরা সেই চ্যানেলের মালিকানাধীন লাইভ সম্প্রচারের সময় কোনও চ্যানেলকে স্পনসর করার জন্য সাইন আপ করেন, তখন API সম্প্রচারের লাইভ চ্যাটে একটিnewSponsorEventবার্তাও যোগ করে।Learn more about sponsorships in the YouTube Help Center .
Updates to existing resources and methods
The
liveBroadcastresource contains the following new properties:বৈশিষ্ট্য snippet.liveChatIdThe ID for the broadcast's YouTube live chat. With this ID, you can use the liveChatMessageresource's methods to retrieve, insert, or delete chat messages. You can also add or remove chat moderators, ban users from participating in live chats, or remove existing bans.contentDetails.closedCaptionsTypeNote: This property replaces the contentDetails.enableClosedCaptionsproperty.
This property indicates whether closed captioning is enabled for your broadcast and, if so, what type of closed captions you are providing:-
closedCaptionsDisabled: Closed captions are disabled for the live broadcast. -
closedCaptionsHttpPost: You will send captions, via HTTP POST, to an ingestion URL associated with your live stream. -
closedCaptionsEmbedded: Captions will be encoded in the video stream using EIA-608 and/or CEA-708 formats.
contentDetails.enableClosedCaptionsThis property has been deprecated as of December 17, 2015. Use the contentDetails.closedCaptionsTypeproperty instead. For API clients that are already using this property:- Setting the property value to
trueis equivalent to setting thecontentDetails.closedCaptionsTypeproperty toclosedCaptionsHttpPost. - Setting the property value to
falseis equivalent to setting thecontentDetails.closedCaptionsTypeproperty toclosedCaptionsDisabled.
-
The
liveBroadcasts.listmethod's newbroadcastTypeparameter lets you filter an API response to include event broadcasts, persistent broadcasts, or all broadcasts.A persistent broadcast is one that always exists and is not tied to a particular event. Specifically, a channel's default broadcast is a persistent broadcast, and it is accessible via the Live Dashboard in the YouTube Creator Studio. The channel's other broadcasts are event broadcasts.
The
liveStreamresource'sstatus.healthStatus.configurationIssues[].typefield reports the following new health status errors:ত্রুটি audioTooManyChannelsThe audio has more than two channels, but only one (mono) or two (stereo) channels are supported. Please correct the number of audio channels. frameRateHighThe current framerate is too high. Please set the framerate to %(framerate)sfps or less.The publication date of the previous documentation update was corrected.
New and updated errors
In addition to errors defined for the new resources listed above, the API supports the following new errors:
Error details liveBroadcasts.updateHTTP Response Code forbidden (403)কারণ closedCaptionsTypeModificationNotAllowedবিবরণ The contentDetails.closedCaptionsTypevalue can only be modified when the broadcast is in thecreatedorreadystatus.liveBroadcasts.updateHTTP Response Code invalidValue (400)কারণ invalidEnableClosedCaptionsবিবরণ In the liveBroadcast resource , the value of the contentDetails.enableClosedCaptionsproperty is incompatible with the value of thecontentDetails.closedCaptionTypesetting. Modify the resource to only include one of the two properties, and then resubmit the request.
১৯ আগস্ট, ২০১৫
This update contains the following changes:
New resources and methods
Note: Documentation for the
liveChatresource and its methods is confidential and only visible to select YouTube partners.The new
liveChatresource contains a comment posted during a live broadcast on YouTube. The API supports two methods for this resource:পদ্ধতি liveChats.listList live chat messages for a broadcast. liveChats.insertCreate a new chat message. Live chat messages can only be retrieved and posted while a broadcast is live.
Updates to existing resources and methods
The
liveStreamresource contains the following new properties:বৈশিষ্ট্য snippet.isDefaultStreamIndicates whether this stream is the default stream for the channel. A channel's default stream exists indefinitely, does not have a start or end time associated with it, and cannot be deleted. See the property's definition for more information about how default streams work. status.healthStatusThis object contains information that could be used to identify, diagnose and resolve streaming problems. The object contains a number of child properties to help you evaluate the health of a live video stream.
In particular, thestatus.healthStatus.configurationIssues[]object lists issues affecting a video stream. A new document, Configuration Issues for LiveStream Resources , lists all of the issues that the API reports.contentDetails.isReusableIndicates whether the stream is reusable, which means that it can be bound to multiple broadcasts. It is common for broadcasters to reuse the same stream for many different broadcasts if those broadcasts occur at different times. The
liveBroadcastresource contains the following new properties:বৈশিষ্ট্য snippet.isDefaultBroadcastIndicates whether this broadcast is the default broadcast for the channel. When a YouTube channel is enabled for live streaming, YouTube creates a default stream and a default broadcast for the channel. The stream defines how the channel owner sends live video to YouTube, and the broadcast is how viewers can see the default stream. See the property's definition for more information about how default broadcasts work. contentDetails.enableLowLatencyIndicates whether this broadcast should be encoded for low-latency streaming. A low-latency stream can reduce the amount of time it takes for video to be visible to users watching a broadcast, though it can also impact the resolution for viewers of the stream. statistics.totalChatCountThe total number of live chat messages associated with the broadcast. The property and its value are present if the broadcast is visible to the user and has the live chat feature enabled. Note that this property will not specify a value after the broadcast ends. So, this property would not identify the number of chat messages for an archived video of a completed live broadcast.
New and updated errors
In addition to errors defined for the new
liveChatresource, the API supports the following new error:Error details liveStreams.updateHTTP Response Code forbidden (403)কারণ liveStreamModificationNotAllowedবিবরণ The API does not allow you to change a reusable stream to be non-reusable, or vice versa. For more information, see Understanding Broadcasts and Streams
May 21, 2015
This update contains the following changes:
YouTube now supports live video streaming at 60 frames per second (fps), which means smoother playback for gaming and other fast-action videos. When you start a live stream on YouTube at 60fps, YouTube also makes the stream available in 30fps on devices where high-frame-rate viewing is not yet available.
The
liveStreamresource'scdn.formatproperty supports two new values for this feature:720p_hfrand1080p_hfr.See the YouTube Creators Blog for more information about this feature.
August 21, 2014
This update contains the following changes:
The definition of the
liveBroadcasts.controlmethod'swalltimeparameter has been updated to note that the property value is specified in ISO 8601 format (YYYY-MM-DDThh:mm:ss.sssZ).The API now supports the following errors:
Error type Error detail বিবরণ insufficientPermissionsliveStreamingNotEnabledAll methods for the liveBroadcastandliveStreamresources return this error if the user that authorized the API request has not been enabled to stream live video on YouTube. Details explaining why the user cannot stream live video may be available in the user's channel settings at https://www.youtube.com/features .rateLimitExceededuserRequestsExceedRateLimitThe liveBroadcasts.insertandliveStreams.insertmethods both return this error to indicate that the user has sent too many requests within a given timeframe.
May 2, 2014
This update contains the following changes:
The descriptions of the
liveStreamresource and of theliveBroadcasts.bindmethod have been updated to note that a broadcast can only be bound to one video stream, but a video stream can be bound to more than one broadcast. This change is solely a correction to the documentation; the underlying API functionality has not changed.The
liveBroadcastresource'scontentDetails.monitorStream.enableMonitorStreamproperty has been updated to explain that if the property's value istrue, then you must transition your broadcast to thetestingstate before you can transition it to thelivestate. (If the property's value isfalse, your broadcast cannot have atestingstage, so you can transition the broadcast directly to thelivestate.The
liveCuepointresource'ssettings.offsetTimeMsproperty has been updated to note that you should not specify a value for the property if your broadcast does not have a monitor stream.All of the methods for the
liveBroadcastandliveStreamresources now support theonBehalfOfContentOwnerandonBehalfOfContentOwnerChannelparameters. These parameters allow you to use the same authorization credentials to complete API requests for different channels associated with the same content owner.The
liveCuepoints.insertmethod's documentation has been updated to note that you can set a value for thesettings.walltimeproperty when calling that method.The error documentation now specifies the HTTP response code for each error type.
The API now supports the following error:
Error type Error detail বিবরণ insufficientPermissionslivePermissionBlockedThe liveBroadcasts.insert,liveBroadcasts.transition, andliveStreams.insertmethods return this error if the user that authorized the request is unable to stream live video on YouTube. Details explaining why the user cannot stream live video may be available in the user's channel settings at https://www.youtube.com/features .The
liveBroadcasts.insertmethod'sinvalidScheduledStartTimeerror has been updated to clarify that the scheduled start time must be close enough to the current date that a broadcast could be reliably scheduled at that time.
December 13, 2013
This update contains the following changes:
The
liveBroadcastresource's newstatus.recordingStatusproperty identifies the broadcast's current status.The
liveBroadcastresource's newcontentDetails.enableClosedCaptionsproperty indicates whether closed captions can be ingested for the broadcast. The property value can be set when you insert or update a broadcast, but it cannot be updated once the broadcast is in thetestingorlivestate. If you set this property totrue, then theliveStreamresource that is bound to the broadcast will specify the ingestion URL to use for the broadcast's closed captions.The
liveBroadcastresource'ssnippet.scheduledEndTimeproperty now supports broadcasts that are scheduled to continue indefinitely. With this change, the property is no longer required inliveBroadcasts.insertandliveBroadcasts.updaterequests.
If you retrieve aliveBroadcastresource that does not specify a value for this property, then the broadcast is scheduled to continue indefinitely. Similarly, if you call theliveBroadcasts.insertorliveBroadcasts.updatemethod and do not specify a value for this property, the broadcast will be scheduled to continue indefinitely.The
liveBroadcastresource'scontentDetails.recordFromStartproperty, which already had a default value oftrue, can now only be set tofalseif the broadcasting channel is allowed to disable recordings for live broadcasts.If your channel does not have permission to disable recordings, and you attempt to insert a broadcast with the
recordFromStartproperty set tofalse, the API will return aForbiddenerror. In addition, if your channel does not have that permission and you attempt to update a broadcast to set therecordFromStartproperty tofalse, the API will return amodificationNotAllowederror.The
liveBroadcastresource no longer contains anenableArchiveproperty, which had been mentioned in the descriptions of thecontentDetails.enableDvrandcontentDetails.enableEmbedproperties.The list of valid values for the
liveBroadcastresource'sstatus.lifeCycleStatusproperty has been updated to include a description of each status.The
liveCuepointresource's newsettings.walltimeproperty specifies the date and time at which the cuepoint should be inserted. The API returns an error if a request tries to insert a cuepoint that specifies a value for this property and for thesettings.offsetTimeMsproperty.The new
contentDetailsobject in aliveStreamresource contains information about the stream. Currently, the object's only property iscontentDetails.closedCaptionsIngestionUrl, which specifies the ingestion URL for closed captions associated with the video stream.The list of valid values for the
liveStreamresource'sstatus.streamStatusproperty has been updated to include a description of each status.The
liveBroadcasts.controlmethod's newwalltimeparameter lets you specify the date and time when a slate change will occur. The API returns an error if a request specifies a value for this parameter and for theoffsetTimeMsparameter.In the API response to a
liveBroadcasts.listrequest, the value of thekindproperty has changed fromyoutube#liveBroadcastListtoyoutube#liveBroadcastListResponse.In the API response to a
liveStreams.listrequest, the value of thekindproperty has changed fromyoutube#liveStreamListtoyoutube#liveStreamListResponse.The
eventIdproperty has been deprecated from both theliveBroadcastListResponseand theliveStreamListResponse.The API supports the following new errors:
Error type Error detail বিবরণ invalidValueconflictingTimeFieldsThe liveBroadcasts.controlmethod returns this error if your request specifies values for theoffsetTimeMsandwalltimeparameters. A request can either omit both parameters or specify a value for one of the two parameters.invalidValueinvalidWalltimeThe liveBroadcasts.controlmethod returns this error if thewalltimeparameter's value is invalid.forbiddenenableClosedCaptionsModificationNotAllowedThe liveBroadcasts.updatemethod returns this error if you attempt to update thecontentDetails.enableClosedCaptionsvalue and the broadcast's status is notcreatedorready.invalidValueconflictingTimeFieldsThe liveCuepoints.insertmethod returns this error if your request specifies values for thesettings.offsetTimeMsandsettings.walltimeproperties. A request can either omit both properties or specify a value for one of the two properties.In addition, the
liveStreams.updatemethod no longer supports acdnRequirederror similar to the one that theliveStreams.insertmethod supports.
May 10, 2013
This update contains the following changes:
YouTube no longer identifies experimental API features and services. Instead, we now provide a list of YouTube APIs that are subject to the deprecation policy .
May 2, 2013
This update contains the following changes:
The new
liveBroadcasts.controlmethod enables you to toggle the display settings for a slate that displays in the broadcast stream for a broadcast that is already in progress. If your broadcast stream is delayed, you can also use this method to specify a time offset when the requested slate change will occur.The definitions of the following properties have been updated to explain that the property values must be set if you update a
liveBroadcastresource'scontentDetailspart:The
liveStreamresource'sstatus.streamStatusno longer supports the valuedeletedas a possible stream status.The information that the API returns for many error messages has been revised to better explain why particular errors occurred. The API also supports several new errors.
March 27, 2013
This update contains the following changes:
The following properties have changed in the
liveBroadcastresource:- The
startWithSlateCuepointproperty has been renamed tostartWithSlate. - The
enableArchiveproperty has been renamed torecordFromStart. - The
slateSettingsobject has been deprecated and removed from the documentation. Error messages related to theslateSettingsobject or its properties have also been removed. Finally, the "Displaying Slates" section of the Getting started guide has been removed.
- The
The API no longer supports the ability to insert in-stream slates using the
liveCuepoints.insertmethod. The following documents have been updated to reflect this change:The index page , Getting started guide, and Life of a broadcast tutorial no longer mention this functionality.
The
liveCuepointresource'ssettings.cueTypeproperty no longer supportsslateas a property value. (The only supported value isad.The
liveCuepointresource'ssettings.eventStateproperty has been deprecated and removed from the documentation.
March 18, 2013
This update contains the following changes:
All of the API's error messages have been updated to more clearly explain possible errors and, when possible, offer guidance about how to fix them.
The API may now return several new errors. The list below identifies the error and the API method that might return that error:
-
liveBroadcasts.insert– A broadcast's scheduled end time must be after its scheduled start time. -
liveBroadcasts.insert– The broadcast specifies an invalid privacy status. -
liveBroadcasts.update– The resource does not contain or does not set a value for thecontentDetails.enableArchiveproperty. -
liveBroadcasts.update– The resource does not contain or does not set a value for thecontentDetails.enableContentEncryptionproperty. -
liveBroadcasts.update– The resource does not contain or does not set a value for thecontentDetails.enableDvrproperty. -
liveStreams.insert– The snippet title must be between 1 and 128 characters long. -
liveStreams.update– The resource does not contain or does not set a value for thesnippet.titleproperty.
-
The
liveStreamresource documentation has been updated to reflect that multicast and WebM are not supported ingestion methods as previously indicated. The list of formats for thecdn.formatproperty has been updated accordingly, and thecdn.multicastIngestionInfoobject and its child properties have been removed from the resource's documentation. In addition,httphas been removed from the list of supportedcdn.ingestionTypevalues.