YouTube Live Streaming API - Revision History

این صفحه تغییرات YouTube Live Streaming API و به‌روزرسانی‌های اسناد را فهرست می‌کند.

‫۱۲ اکتبر ۲۰۲۶

این به‌روزرسانی شامل تغییرات زیر است:

  • ویژگی snippet.giftEventDetails منبع liveChatMessage به snippet.giftDetails اصلاح شده است تا پاسخ میانای برنامه‌سازی کاربردی را به‌درستی منعکس کند.

‫۱۸ اوت ۲۰۲۶

این به‌روزرسانی شامل تغییرات زیر است:

  • اسناد روش liveBroadcasts.update به‌روز شده است تا خطاهای جدید مربوط به درآمدزایی را دربرگیرد: preconditionFailed (412) (دلیل: videoNotEligibleForAdsMonetization) و backendError (503) (دلیل: backendError).

‫۱۷ اوت ۲۰۲۶

این به‌روزرسانی شامل تغییرات زیر است:

  • ویژگی جدید snippet.categoryId منبع liveBroadcast به شما امکان می‌دهد دسته ویدیویی مرتبط با پخش مستقیم را تنظیم، به‌روزرسانی، و بازیابی کنید.

‫۲۰ ژوئیه ۲۰۲۶

این به‌روزرسانی شامل تغییرات زیر است:

  • اکنون می‌توان ویژگی monetizationDetails.cuepointSchedule.pauseAdsUntil را روی تاریخ و زمان گذشته یا مقدار خالی تنظیم کرد تا آگهی‌ها از حالت توقف موقت خارج شوند.

‫۹ ژوئیه ۲۰۲۶

این به‌روزرسانی شامل تغییرات زیر است:

‫۱ ژوئن ۲۰۲۶

این به‌روزرسانی شامل تغییرات زیر است:

  • ویژگی contentDetails.availabilityConfig منبع liveBroadcast به شما امکان می‌دهد محدودیت‌های جغرافیایی را برای پخش زنده مشخص کنید تا بتوانید دردسترس بودن منطقه‌ای را برای رویدادهای زنده مدیریت کنید.

‫۲۶ مارس ۲۰۲۶

این به‌روزرسانی شامل تغییرات زیر است:

  • ویژگی snippet.type اکنون از مقدار جدید giftEvent پشتیبانی می‌کند.

  • ویژگی جدید snippet.giftEventDetails منبع liveChatMessage و فرزندان آن حاوی اطلاعاتی درباره رویداد هدیه است.

‫۱۲ ژانویه ۲۰۲۶

اکنون میانای برنامه‌سازی کاربردی از فعال کردن میان‌ویدیویی و درج خودکار میان‌ویدیویی برای پخش‌های زنده پشتیبانی می‌کند.

مالک همه‌فرستی می‌تواند میان‌پخش‌ها را برای همه‌فرستی فعال کند، به‌شرطی که همه‌فرستی واجدشرایط میان‌پخش باشد. مالک همچنین می‌تواند هرزمان که بخواهد آگهی‌های میان‌ویدیویی را برای یک پخش خاموش کند.

اگر همه‌فرستی برای آگهی میان‌ویدیویی فعال باشد، مالک همه‌فرستی می‌تواند انتخاب کند که درج خودکار آگهی میان‌ویدیویی را فعال کند. همچنین می‌توانند آگهی‌های خودکار را هرزمان بخواهند برای همه‌فرستی خاموش کنند.

وقتی مالک همه‌فرستی آگهی‌های خودکار را فعال می‌کند، می‌تواند یکی از گزینه‌های زیر را انتخاب کند:

  • اجازه دهید YouTube درج آگهی میان‌ویدیویی را بهینه‌سازی کند. این گزینه از سه حالت پشتیبانی می‌کند:
    • کم: درآمد بالقوه کمتر، تجربه بیننده با وقفه کمتر
    • متوسط: درآمد بالقوه متوسط، تجربه بیننده متعادل
    • بالا: درآمد بالقوه بیشتر، تجربه بیننده با وقفه بیشتر
  • استراتژی و فاصله زمانی درج آگهی میان‌ویدیویی را به‌طور دستی پیکربندی کنید. دراین‌صورت، مالک باید دو پارامتر را تنظیم کند:
    1. استراتژی زمان‌بندی برای نقاط نشانه آگهی. نقطه‌های راهنما را می‌توان به‌طور هم‌زمان برای همه بینندگان درج کرد یا زمان‌بندی نقطه‌های راهنما می‌تواند برای هر بیننده متفاوت باشد. راهبرد دوم به YouTube امکان می‌دهد تا نقاط نشان را با نرخ بالاتری زمان‌بندی کند که به بینندگان اجازه می‌دهد نقاط نشان را زمانی که واجدشرایط هستند دریافت کنند.
    2. طول فاصله بین وقفه‌های آگهی میان‌ویدیویی.

این مستندات نشان‌دهنده تغییرات زیر در میانای برنامه‌سازی کاربردی برای پشتیبانی از این ویژگی است:

  • شیء monetizationDetails منبع liveBroadcast حاوی فیلدهایی برای فعال‌سازی آگهی میان‌ویدیویی و پیکربندی‌های آگهی خودکار است.
  • از روش update می‌توان برای فعال یا غیرفعال کردن آگهی‌های میان‌ویدیویی استفاده کرد. از این روش می‌توان برای راه‌اندازی آگهی‌های خودکار برای پخش زنده نیز استفاده کرد. این سند چندین خطای جدید را که ممکن است هنگام به‌روزرسانی تنظیمات درآمدزایی و آگهی‌های خودکار برای پخش زنده رخ دهد، شناسایی می‌کند.

‫۱۴ ژوئیه ۲۰۲۵

شرح روش liveChatMessages.streamList به‌روز شده است تا راهنمایی‌هایی درباره استفاده از میانای برنامه‌سازی کاربردی streamList ارائه دهد.

۹ اکتبر ۲۰۲۳

فقط برای مرجع، می‌توانید در این فایل CSV ببینید که کدام شناسه‌های برچسب به کدام Super Sticker مربوط می‌شوند. تعاریف ویژگی snippet.superStickerDetails.superStickerMetadata.stickerId منبع liveChatMessage و ویژگی snippet.superStickerMetadata.stickerId منبع superChatEvent هر دو به‌روزرسانی شده‌اند تا این اطلاعات را منعکس کنند.

‫۱۵ سپتامبر ۲۰۲۳

اکنون این میانای برنامه‌سازی کاربردی از روش جدیدی برای درج آگهی در پخش‌های زنده پشتیبانی می‌کند. علاوه‌بر liveCuepoints که به شما امکان می‌دهد وقفه‌های آگهی را به‌صورت دستی در پخش زنده درج کنید، YouTube اکنون از ویژگی‌ای پشتیبانی می‌کند که به‌طور خودکار وقفه‌های آگهی میان‌ویدیویی را در فواصل زمانی ثابت در پخش زنده درج می‌کند.

اگر مالک همه‌فرستی آگهی‌های خودکارشده را فعال کند، می‌تواند جنبه‌های زیر را از رفتار آگهی مشاهده کند:

  • طول فاصله بین وقفه‌های آگهی میان‌ویدیویی.
  • استراتژی زمان‌بندی برای نقاط نشانه آگهی. نقطه‌های راهنما را می‌توان به‌طور هم‌زمان برای همه بینندگان درج کرد یا زمان‌بندی نقطه‌های راهنما می‌تواند برای هر بیننده متفاوت باشد. راهبرد دوم به YouTube امکان می‌دهد تا نقاط نشان را با نرخ بالاتری زمان‌بندی کند که به بینندگان اجازه می‌دهد نقاط نشان را زمانی که واجدشرایط هستند دریافت کنند.
  • دوره‌ای که در آن آگهی‌های میان‌ویدیویی نمایش داده نمی‌شوند؛ برای این ویژگی، مالک پخش مشخص می‌کند که درج آگهی‌های میان‌ویدیویی تا زمان خاصی موقتاً متوقف شود.

این مستندات نشان‌دهنده تغییرات زیر در میانای برنامه‌سازی کاربردی برای پشتیبانی از این ویژگی است:

  • منبع liveBroadcast اکنون حاوی شیء monetizationDetails است. فیلدهای شیء نشان می‌دهند که آیا درج خودکار آگهی برای پخش فعال است یا خیر و اطلاعات بیشتری را برای زمان‌بندی نقاط نشانگر مشخص می‌کنند.
  • پارامتر part روش liveBroadcast.list از مقدار monetizationDetails پشتیبانی می‌کند.
  • از روش update می‌توان برای توقف موقت درج آگهی‌های میان‌ویدیویی برای یک دوره خاص در پخش زنده استفاده کرد. اکنون این سند همچنین چندین خطا را که ممکن است هنگام به‌روزرسانی جزئیات درآمدزایی برای پخش زنده رخ دهد، شناسایی می‌کند.

۱ اوت ۲۰۲۳

این به‌روزرسانی شامل تغییرات زیر است:

  • روش liveBroadcasts.update دیگر نیازی به تعیین مقادیر برای این فیلدها ندارد:

    • snippet.title
    • status.privacyStatus

    با حذف این فیلدها از درخواست، آن‌ها بدون تغییر باقی می‌مانند.

‫۱ نوامبر ۲۰۲۲

  • روش جدید liveBroadcasts.cuepoint به هر مالک کانالی که درحال اجرای پخش مستقیم در YouTube است امکان می‌دهد تا نقاط نشان را در آن پخش درج کند، که می‌تواند وقفه‌های آگهی را راه‌اندازی کند. این روش جایگزین روش liveCuepoints.insert می‌شود که فقط به شرکای محتوای YouTube اجازه می‌داد تا نقاط نشان را در پخش‌های زنده درج کنند.

    چندین راهنما به‌روز شده‌اند تا دردسترس بودن این روش جدید را نشان دهند.

  • توجه: این یک اعلان منسوخ شدن است.

    روش 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

  • ویژگی جدید snippet.membershipGiftingDetails منبع liveChatMessage و فرزندان آن حاوی اطلاعاتی درباره رویداد «هدیه دادن عضویت» است. به‌طور مشابه، ویژگی جدید snippet.giftMembershipReceivedDetails و فرزندان آن حاوی اطلاعاتی درباره رویداد «عضویت هدیه‌ای دریافت شد» هستند.

‫۱۵ سپتامبر ۲۰۲۱

این به‌روزرسانی شامل تغییرات زیر است:

  • ویژگی snippet.type اکنون از دو مقدار جدید پشتیبانی می‌کند:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • ویژگی جدید snippet.memberMilestoneChatDetails منبع liveChatMessage و فرزندان آن حاوی اطلاعاتی درباره رویداد «گپ اعضای وفادار» است. به‌طور مشابه، ویژگی جدید snippet.newSponsorDetails و فرزندان آن حاوی اطلاعاتی درباره رویداد «حامی مالی جدید» هستند.

‫۱ دسامبر ۲۰۲۰

روش liveBroadcasts.transition میانای برنامه‌سازی کاربردی از خطای جدید 403 (Forbidden) پشتیبانی می‌کند که نشان می‌دهد کاربر در بازه زمانی مشخصی درخواست‌های زیادی ارسال کرده است. دلیل خطا userRequestsExceedRateLimit است.

‫۲۱ سپتامبر ۲۰۲۰

  • تعریف ویژگی status.madeForKids منبع liveBroadcast به‌روزرسانی شده است تا مشخص شود که این ویژگی فقط خواندنی است. این نشان‌دهنده تغییر در عملکرد میانای برنامه‌سازی کاربردی نیست.

    برای تعیین اینکه پخش مستقیم برای کودکان ساخته شده است، هنگام فراخوانی روش liveBroadcasts.insert برای ایجاد پخش، ویژگی status.selfDeclaredMadeForKids را روی true تنظیم کنید.

  • توجه: این تغییر شامل اعلامیه منسوخ شدن و به‌روزرسانی اعلامیه منسوخ شدن قبلی است.

    روش liveBroadcasts.control در تاریخ ۱ اکتبر ۲۰۲۰ یا پس‌از آن منسوخ خواهد شد. پس‌از این تاریخ، همه فراخوانی‌های این روش خطای ممنوع (۴۰۳) برمی‌گرداند و این روش بعداً به‌طور کامل برداشته خواهد شد. کارخواه‌ها همچنان می‌توانند با افزودن هم‌پوشانی به ویدیو ارسال‌شده به سرورهای دریافت YouTube، لوح خودشان را پیاده‌سازی کنند.

    تاریخ منسوخ شدن برای اعلامیه منسوخ شدن که در ۱۶ آوریل ۲۰۲۰ منتشر شد و در ابتدا برای ۱ سپتامبر ۲۰۲۰ برنامه‌ریزی شده بود، به تعویق افتاده است و اکنون در ۱ اکتبر ۲۰۲۰ یا پس‌از آن اتفاق خواهد افتاد. بنابراین، ویژگی‌های موجود در آن اعلامیه منسوخ شدن و روش liveBroadcasts.control همگی به‌طور هم‌زمان منسوخ خواهند شد.

‫۱۷ ژوئیه ۲۰۲۰

توجه: این به‌روزرسانی برای اعلامیه منسوخ‌سازی قبلی است.

فیلد cdn.format منبع liveStream که در آوریل ۲۰۱۶ منسوخ شده بود، از ۱۷ اوت ۲۰۲۰ دیگر پشتیبانی نخواهد شد. درخواست‌هایی که همچنان از آن فیلد استفاده می‌کنند از آن تاریخ ناموفق خواهند بود.

اگر کد شما همچنان از فیلد cdn.format استفاده می‌کند، باید به‌روزرسانی شود تا نرخ فریم و وضوح را به‌طور جداگانه بااستفاده از ویژگی‌های cdn.frameRate و cdn.resolution مشخص کند.

۶ ژوئیه ۲۰۲۰

راهنمای ارسال محتوای زنده YouTube ازطریق HLS با چند تغییر به‌روز شده است:

علاوه‌براین، مقایسه پروتکل انتقال جدید پروتکل‌های انتقالی را که YouTube پشتیبانی می‌کند، کدک‌های پشتیبانی‌شده برای هر پروتکل، و اطلاعات تکمیلی درباره موارد استفاده مناسب برای هر پروتکل را فهرست می‌کند.

‫۱۶ آوریل ۲۰۲۰

این به‌روزرسانی شامل یک ویژگی جدید و یک اعلامیه منسوخ شدن است:

  • منبع liveBroadcast اکنون از ویژگی contentDetails.enableAutoStop پشتیبانی می‌کند. این ویژگی نشان می‌دهد که آیا همه‌فرستی باید حدود یک دقیقه پس‌از اینکه مالک کانال جاری‌سازی ویدیو را در جاری‌سازی ویدیو محدودشده متوقف کرد، به‌طور خودکار متوقف شود یا نه.

    سند عمر همه‌فرستی به‌روزرسانی شده است تا توضیح دهد که اگر ویژگی‌های contentDetails.enableAutoStart یا contentDetails.enableAutoStop را روی true تنظیم کنید، فرایند گام‌به‌گام ایجاد و مدیریت رویداد زنده YouTube چگونه تغییر می‌کند.

  • توجه: این یک اعلان منسوخ شدن است. این تغییرات از ۱ سپتامبر ۲۰۲۰ یا پس‌از آن اعمال خواهد شد. تاریخ واقعی اعمال تغییرات در زیر به‌عنوان تاریخ منسوخ شدن ذکر شده است.

    این به‌روزرسانی تغییری را توضیح می‌دهد که ممکن است باعث خرابی شود. این تغییر بر برنامه‌های کارخواه API که از منابع پیش‌فرض liveStream و liveBroadcast کانال‌ها برای جاری‌سازی محتوای زنده در YouTube استفاده می‌کنند تأثیر می‌گذارد. به‌طور خاص، شناسه همه‌فرستی و شناسه جاری‌سازی مرتبط با همه‌فرستی و جاری‌سازی پایدار دیگر برای شروع همه‌فرستی‌های جدید کار نخواهند کرد.

    اگر هریک از موارد زیر درست باشد، برنامه شما تحت‌تأثیر قرار خواهد گرفت:

    • مقدار ویژگی isDefaultBroadcast منبع liveBroadcast را بررسی می‌کند. این ویژگی پس‌از تاریخ منسوخ شدن برگردانده نخواهد شد.
    • این خط‌مشی مقدار ویژگی isDefaultStream منبع liveStream را بررسی می‌کند. این ویژگی پس‌از تاریخ منسوخ شدن برگردانده نخواهد شد.
    • این روش liveBroadcasts.list را فراخوانی می‌کند و مقدار پارامتر broadcastType را روی persistent یا all تنظیم می‌کند. این پارامتر به‌عنوان بخشی از این تغییرات منسوخ خواهد شد. از تاریخ منسوخ شدن:
      • اگر مقدار پارامتر broadcastType برابر با persistent باشد، روش liveBroadcasts.list هیچ نتیجه‌ای برنمی‌گرداند.
      • اگر مقدار پارامتر broadcastType برابر با all باشد، روش liveBroadcasts.list همه‌فرستی‌های پایداری را که قبل‌از آن زمان وجود داشته‌اند برنمی‌گرداند.

    به‌عنوان پیش‌زمینه، در چند سال گذشته، YouTube به‌طور خودکار یک جاری‌سازی پیش‌فرض و یک همه‌فرستی پیش‌فرض برای کانال ایجاد کرده است، زمانی که آن کانال برای جاری‌سازی زنده فعال شده بود. جاری‌سازی پیش‌فرض به‌طور نامحدود وجود داشت، زمان شروع یا پایان مرتبط با آن نداشت و قابل حذف نبود. به‌طور مشابه، همه‌فرستی پیش‌فرض پایدار درنظر گرفته می‌شد. همیشه وجود داشته است و به رویداد خاصی محدود نبوده است.

    از تاریخ منسوخ شدن:

    • YouTube دیگر جاری‌سازی‌ها و همه‌فرستی‌های پیش‌فرض ایجاد نخواهد کرد. به‌جای تکیه بر منابع پیش‌فرض، کارخواه‌های میانای برنامه‌سازی کاربردی باید بتوانند منابع liveBroadcast و liveStream را ایجاد و مدیریت کنند و این منابع را به یکدیگر متصل کنند.
    • اگر همه‌فرستی پیش‌فرض و جاری‌سازی پیش‌فرض کانال به‌طور فعال زنده باشند، یعنی کانال در زمان اجرایی شدن منسوخ‌سازی از آن‌ها برای همه‌فرستی زنده استفاده می‌کند، همه‌فرستی جاری تحت‌تأثیر قرار نخواهد گرفت. اما پس‌از پایان آن همه‌فرستی، کانال دیگر نمی‌تواند از همه‌فرستی پیش‌فرض و جاری‌سازی پیش‌فرض استفاده کند.
    • اگر پخش پیش‌فرض و جاری‌سازی پیش‌فرض کانال به‌طور فعال زنده نباشند، پس‌از اجرایی شدن منسوخ‌سازی، YouTube تلاش‌ها برای استفاده از آن منابع برای پخش ویدیو را نادیده خواهد گرفت.

    اگر برنامه شما تحت‌تأثیر قرار گرفته است، لطفاً به اسناد زیر مراجعه کنید که به شما کمک می‌کند برنامه‌تان را به‌روز کنید تا پس‌از این تغییر همچنان طبق انتظار کار کند:

    • راهنمای انتقال جدیدی سعی می‌کند مراحلی را توضیح دهد که ممکن است توسعه‌دهندگان لازم باشد در کارخواهان میانای برنامه‌سازی کاربردی که درحال‌حاضر از همه‌فرستی‌ها و جاری‌سازی‌های پیش‌فرض استفاده می‌کنند به آن‌ها بپردازند.
    • راهنمای Life of a broadcast شما را در فرایندی گام‌به‌گام راهنمایی می‌کند که نحوه ایجاد و مدیریت رویداد زنده در YouTube را توضیح می‌دهد. هر مرحله فراخوانی‌های API یا کارهای دیگری را که باید برای تکمیل یک کنش خاص انجام دهید توضیح می‌دهد، و برنامه شما باید زمانی که YouTube پشتیبانی از جاری‌سازی‌ها و همه‌فرستی‌های پیش‌فرض را متوقف می‌کند، آن فرایند را دنبال کند.

‫۳۱ مارس ۲۰۲۰

توجه: این یک اعلان منسوخ شدن است.

منبع sponsor و روش sponsors.list منسوخ شده‌اند و منبع member و روش members.list جایگزین آن‌ها شده‌اند.

روش sponsors.list از ۳۰ سپتامبر ۲۰۲۰ دیگر پشتیبانی نخواهد شد. کارخواه‌های API باید تماس‌ها با روش sponsors.list را به‌روز کنند تا به‌جای آن از روش members.list استفاده کنند. لطفاً برای اطلاعات بیشتر درباره منبع جدید، سابقه بازبینی YouTube Data API را ببینید.

‫۱۱ مارس ۲۰۲۰ (۲۱ اسفند ۱۳۹۸)

بخش نقطه پایانی انتقال داده در راهنمای ارائه محتوای زنده YouTube ازطریق HLS به‌روزرسانی شده است تا فرایندی را که کدبند باید برای تکمیل مقدار پارامتر file= هنگام تشکیل نشانی‌های وب انتقال داده اصلی و پشتیبان استفاده کند، شفاف‌سازی کند.

‫۴ فوریه ۲۰۲۰ (۱۵ بهمن ۱۳۹۸)

راهنمای ارائه محتوای زنده YouTube ازطریق HLS به‌روزرسانی شده است تا اشاره کند که درخواست‌های DELETE اختیاری هستند و نقطه پایانی HLS در YouTube آن‌ها را نادیده می‌گیرد. به‌دلایل عملکردی، YouTube توصیه می‌کند که کارخواه‌ها درخواست‌های DELETE ارسال نکنند.

‫۱۰ ژانویه ۲۰۲۰ (۲۰ دی ۱۳۹۸)

اکنون API از قابلیت شناسایی محتوای ویژه کودکان پشتیبانی می‌کند که YouTube آن را «ساخته‌شده برای کودکان» می‌نامد. درباره محتوای «ساخته‌شده برای کودکان» در «مرکز راهنمایی YouTube» بیشتر بدانید.

  • منبع liveBroadcast از دو ویژگی جدید پشتیبانی می‌کند تا محتواسازان و بینندگان بتوانند محتوای «ساخته‌شده برای کودکان» را شناسایی کنند:
    • ویژگی selfDeclaredMadeForKids به محتواسازان امکان می‌دهد مشخص کنند که آیا پخش زنده محتوای مخصوص کودکان است یا نه. این ویژگی را می‌توان هنگام ایجاد یک پخش ازطریق روش liveBroadcasts.insert تنظیم کرد. توجه داشته باشید که این ویژگی فقط در پاسخ‌های API که حاوی منابع liveBroadcast هستند، درصورتی‌که مالک کانال درخواست API را مجاز کرده باشد، گنجانده می‌شود.
    • ویژگی madeForKids به هر کاربر میانای برنامه‌سازی کاربردی امکان می‌دهد وضعیت «ساخته‌شده برای کودکان» را برای همه‌فرستی بازیابی کند. برای مثال، ممکن است وضعیت براساس مقدار ویژگی selfDeclaredMadeForKids تعیین شود. برای اطلاعات بیشتر درباره تنظیم مخاطب برای کانال، ویدیوها، یا همه‌فرستی‌هایتان، به مرکز راهنمایی YouTube مراجعه کنید.
  • در YouTube Data API، منبع channel از ویژگی‌های جدید selfDeclaredMadeForKids و madeForKids نیز پشتیبانی می‌کند.

همچنین «شرایط خدمات سرویس‌های YouTube API» و «خط‌مشی‌های توسعه‌دهنده» را به‌روز کرده‌ایم. لطفاً برای کسب اطلاعات بیشتر، به شرایط خدمات سرویس‌های YouTube API - سابقه بازبینی مراجعه کنید. تغییرات در «شرایط خدمات سرویس‌های YouTube API» و «خط‌مشی‌های توسعه‌دهنده» از ۱۰ ژانویه ۲۰۲۰ به‌وقت اقیانوس آرام اعمال خواهد شد.

‫۲۰ اوت ۲۰۱۹

بخش الزامات راهنمای ارسال محتوای زنده YouTube ازطریق HLS با دو تغییر به‌روزرسانی شده است:

  • این سند توضیح می‌دهد که بهترین روش این است که هم بخش‌های تأییدشده و هم بخش‌های معوقه در هر «فهرست پخش رسانه» گنجانده شوند. این کار احتمال رد شدن بخش را درصورت ازدست رفتن «فهرست پخش رسانه» در سمت سرور کاهش می‌دهد. برای مثال، می‌توانید حداکثر دو بخش تأییدشده و حداکثر پنج بخش معوقه را در هر «فهرست پخش رسانه» بگنجانید.
  • اکنون ارسال «فهرست پخش رسانه» برای هر «بخش رسانه» الزامی است. این کار به سرور امکان می‌دهد درصورت ازدست رفتن «فهرست پخش رسانه» به‌سرعت بازیابی شود. این روش قبلاً به‌عنوان توصیه فهرست شده بود.

۲۸ ژوئن ۲۰۱۹

‫YouTube اکنون از انتقال داده HLS پشتیبانی می‌کند. بر این اساس، ویژگی ingestionType منبع liveStream از مقدار جدید hls برای شناسایی جاری‌سازی‌های منتقل‌شده به YouTube بااستفاده از HLS پشتیبانی می‌کند.

راهنمای جدید ارسال محتوای زنده YouTube ازطریق HLS دستورالعمل‌هایی برای استفاده از HLS جهت جاری‌سازی محتوای زنده به YouTube از کدبند ارائه می‌دهد. هدف این راهنما کمک به فروشندگان کدبند برای افزودن پشتیبانی از ارسال HLS به محصولاتشان است.

۴ آوریل ۲۰۱۹

این به‌روزرسانی شامل تغییرات زیر است:

  • سند مرجع API به‌روزرسانی شده است تا موارد استفاده رایج برای هر روش را بهتر توضیح دهد و نمونه‌های کد پویا و با کیفیت بالا را ازطریق ابزاره APIs Explorer ارائه دهد. برای مشاهده نمونه، به مستندات روش liveBroadcasts.list مراجعه کنید. اکنون دو عنصر جدید در صفحه‌هایی که روش‌های میانای برنامه‌سازی کاربردی را شرح می‌دهند وجود دارد:

    • ابزارک API Explorer به شما امکان می‌دهد دامنه‌های مجوز را انتخاب کنید، پارامترهای نمونه و مقادیر ویژگی را وارد کنید، و سپس درخواست‌های واقعی API را ارسال کنید و پاسخ‌های واقعی API را ببینید. این ابزارک همچنین نمای تمام‌صفحه‌ای ارائه می‌دهد که نمونه‌های کد کامل را نشان می‌دهد، که به‌طور پویا به‌روزرسانی می‌شوند تا از دامنه‌ها و مقادیری که وارد کرده‌اید استفاده کنند.

    • بخش موارد استفاده رایج یک یا چند مورد استفاده رایج را برای روش توضیح‌داده‌شده در صفحه شرح می‌دهد. برای مثال، می‌توانید روش liveBroadcasts.list را برای بازیابی داده‌های مربوط به یک همه‌فرستی خاص یا بازیابی داده‌های مربوط به همه‌فرستی‌های کاربر فعلی فراخوانی کنید.

      می‌توانید از پیوندهای موجود در آن بخش برای پر کردن API Explorer با مقادیر نمونه برای مورد استفاده‌تان یا برای باز کردن API Explorer تمام‌صفحه با مقادیری که قبلاً پر شده‌اند استفاده کنید. هدف از این تغییرات این است که بتوانید نمونه کدهایی را که مستقیماً برای مورد استفاده‌ای که می‌خواهید در برنامه خودتان پیاده‌سازی کنید قابل‌اجرا هستند راحت‌تر ببینید.

    درحال‌حاضر نمونه‌های کد برای Java،‏ JavaScript،‏ PHP،‏ Python، و curl پشتیبانی می‌شود.

  • صفحه نمونه‌های کد نیز واسط کاربر جدیدی دارد که همه ویژگی‌های شرح‌داده‌شده در بالا را ارائه می‌دهد. بااستفاده از این ابزار، می‌توانید موارد استفاده از روش‌های مختلف را کاوش کنید، مقادیر را در «کاوشگر API» بار کنید، و «کاوشگر API» تمام‌صفحه را باز کنید تا نمونه‌های کد را در Java،‏ JavaScript،‏ PHP، و Python دریافت کنید.

    هم‌زمان با این تغییر، صفحه‌هایی که قبلاً نمونه کدهای دردسترس برای Java،‏ PHP، و Python را فهرست می‌کردند برداشته شده‌اند.

۲۵ فوریه ۲۰۱۹

اسناد منابع liveChatMessage و superChatEvent به‌روزرسانی شده‌اند تا نشان دهند که هر دو منبع اکنون می‌توانند حاوی اطلاعاتی درباره Super Stickers باشند. Super Stickers نوعی پیام Super Chat است که تصویری را نمایش می‌دهد. مانند Super Chat، پیام Super Sticker توسط طرفدار درطول جاری‌سازی زنده YouTube خریداری می‌شود.

  • در منبع liveChatMessage، ویژگی snippet.type اکنون روی superStickerEvent تنظیم شده است تا نشان دهد منبع حاوی اطلاعاتی درباره Super Sticker است. در این حالت، منبع همچنین حاوی شیء snippet.superStickerDetails است که اطلاعات بیشتری درباره Super Sticker دارد.
  • در منبع superChatEvent، مقدار بولی snippet.isSuperStickerEvent نشان می‌دهد که آیا پیام Super Chat،‏ Super Sticker هم هست یا نه. اگر چنین باشد، شیء snippet.superStickerMetadata حاوی جزئیات بیشتری درباره Super Sticker است.

۵ آوریل ۲۰۱۸

شرح روش superChatEvents.list به‌روز شده است تا نشان دهد که پاسخ میانای برنامه‌سازی کاربردی دیگر حاوی fanFundingEvents نیست، که در اوایل سال ۲۰۱۷ منسوخ شده بود.

‫۳ آوریل ۲۰۱۷

نمونه‌های کد Java جدیدی اضافه شده است که نحوه فهرست کردن، درج کردن، و حذف کردن پیام‌های گپ مستقیم را نشان می‌دهد. نمونه‌ها روش‌های زیر را فراخوانی می‌کنند:

‫۱۳ فوریه ۲۰۱۷

این به‌روزرسانی شامل تغییرات زیر است:

  • به‌روزرسانی‌های منابع و روش‌های موجود

    • روش liveCuepoints.insert به‌روز شده است تا نشان دهد که پارامتر onBehalfOfContentOwner درحال‌حاضر الزامی است. علاوه‌براین، شرح روش به‌روز شده است تا مشخص شود که تماس‌ها با آن روش باید توسط حسابی که با «مالک محتوای YouTube» مرتبط است مجاز شود.

‫۹ فوریه ۲۰۱۷

این به‌روزرسانی شامل تغییرات زیر است:

  • به‌روزرسانی‌های منابع و روش‌های موجود

    • پارامتر جدید hl در روش superChatEvents.list به شما امکان می‌دهد مشخص کنید که مقدار ویژگی snippet.displayString باید طبق قراردادهای یک زبان خاص قالب‌بندی شود. تعریف آن دارایی نیز براساس آن به‌روز شده است.

      مقدار پارامتر باید کد زبانی باشد که در فهرست برگردانده‌شده توسط روش i18nLanguages.list گنجانده شده است. مقدار پیش‌فرض en است، یعنی رفتار پیش‌فرض این است که رشته‌های نمایشی به‌گونه‌ای قالب‌بندی شوند که در انگلیسی استفاده می‌شوند. برای مثال، به‌طور پیش‌فرض، رشته به‌جای $1,00 به‌صورت $1.00 قالب‌بندی می‌شود.

۱ فوریه ۲۰۱۷

این به‌روزرسانی شامل تغییرات زیر است:

  • منابع و روش‌های جدید

    • منبع جدید superChatEvent نشان‌دهنده پیام Super Chat است که طرفداری درطول جاری‌سازی زنده YouTube خریداری کرده است. در جاری‌سازی گپ مستقیم YouTube، «اَبَر گپ‌ها» به دو روش از پیام‌های دیگر متمایز می‌شوند:

      • Super Chat با یک رنگ برجسته می‌شود.
      • Super Chat برای مدت زمان مشخصی در تیکر سنجاق می‌شود.

      رنگ Super Chat، مدت زمانی که در تیکر سنجاق می‌ماند، و حداکثر طول پیام همگی براساس مبلغ خرید تعیین می‌شوند. مرکز راهنمایی YouTube اطلاعات بیشتری درباره Super Chat دارد.

      میانای برنامه‌سازی کاربردی از روشی برای فهرست کردن رویدادهای Super Chat برای جاری‌سازی‌های زنده کانال در ۳۰ روز گذشته پشتیبانی می‌کند. این روش همچنین داده‌های مربوط به رویدادهای «تأمین بودجه از طرف طرفداران» (fanFundingEvents) را از آخرین جاری‌سازی زنده کانال برمی‌گرداند.

  • به‌روزرسانی‌های منابع و روش‌های موجود

    • ویژگی snippet.type اکنون از مقدار superChatEvent پشتیبانی می‌کند که نشان می‌دهد منبع Super Chat را توصیف می‌کند.

      علاوه‌براین، ویژگی جدید snippet.superChatDetails منبع liveChatMessage و فرزندان آن حاوی اطلاعاتی درباره رویداد Super Chat هستند.

    • ویژگی cdn.resolution منبع liveStream اکنون از مقدار 2160p پشتیبانی می‌کند.

  • خطاهای جدید و به‌روزشده

    • این میانای برنامه‌سازی کاربردی از خطاهای جدید زیر پشتیبانی می‌کند:

      جزئیات خطا
      liveBroadcasts.insert، liveBroadcasts.update روش‌های liveBroadcasts.insert و liveBroadcasts.update خطاهای 400 (Bad Request) را برمی‌گردانند تا نشان دهند منبع liveBroadcast که درج یا به‌روزرسانی می‌شود حاوی مقدار نامعتبری برای ویژگی contentDetails.enableEmbed یا ویژگی contentDetails.projection است. دلیل دو خطای جدید به‌ترتیب invalidEmbedSetting و invalidProjection است.

۱۲ ژانویه ۲۰۱۷

توجه: این یک اعلان منسوخ شدن است.

هم‌زمان با انتشار ویژگی جدید Super Chat، YouTube ویژگی «تأمین بودجه طرفداران» را منسوخ کرده است و Fan Funding API در ۲۸ فوریه ۲۰۱۷ خاموش خواهد شد. از آن تاریخ:

۱۱ اوت ۲۰۱۶

این به‌روزرسانی شامل تغییرات زیر است:

  • «شرایط خدمات سرویس‌های YouTube API» که به‌تازگی منتشر شده است («شرایط به‌روزشده») و به‌طور مفصل در وبلاگ مهندسی و توسعه‌دهندگان YouTube مورد بحث قرار گرفته است، مجموعه غنی از به‌روزرسانی‌ها را برای «شرایط خدمات» فعلی ارائه می‌دهد. علاوه‌بر شرایط به‌روزشده که از ۱۰ فوریه ۲۰۱۷ اجرایی می‌شود، این به‌روزرسانی شامل چندین سند پشتیبانی است که به توضیح خط‌مشی‌هایی که توسعه‌دهندگان باید دنبال کنند کمک می‌کند.

    مجموعه کامل اسناد جدید در سابقه ویرایش «شرایط» به‌روزشده شرح داده شده است. علاوه‌براین، تغییرات آتی در «شرایط به‌روزشده» یا در آن اسناد پشتیبانی نیز در آن سابقه ویرایش توضیح داده خواهد شد.

‫۲۰ مه ۲۰۱۶

YouTube اکنون از انتقال DASH پشتیبانی می‌کند. بر این اساس، ویژگی ingestionType منبع liveStream از مقدار جدید dash برای شناسایی جریان‌های واردشده به YouTube بااستفاده از DASH پشتیبانی می‌کند.

راهنمای جدید ارسال محتوای زنده YouTube ازطریق DASH دستورالعمل‌هایی را برای استفاده از قالب «ارسال DASH» برای جاری‌سازی داده‌های زنده در YouTube از کدبند ارائه می‌دهد. هدف از این سند کمک به فروشندگان کدبند برای افزودن پشتیبانی از ارسال DASH به محصولاتشان است.

‫۱۸ آوریل ۲۰۱۶

این به‌روزرسانی شامل تغییرات زیر است:

  • به‌روزرسانی‌های منابع و روش‌های موجود

    • liveStream به‌روزرسانی منبع

      • YouTube اکنون از پخش‌های زنده با وضوح 1440p با سرعت ۳۰ یا ۶۰ فریم در ثانیه پشتیبانی می‌کند.

        علاوه‌براین، منبع liveStream حاوی ویژگی‌های جدیدی برای مشخص کردن نرخ فریم و وضوح داده‌های ویدیویی ورودی است:

        مشخصات
        cdn.frameRate نرخ فریم داده‌های ویدیویی ورودی. مقادیر معتبر 30fps و 60fps است.
        cdn.resolution وضوح داده‌های ویدیو ورودی. مقادیر معتبر خصوصیت عبارتند از: 1440p، 1080p، 720p، 480p، 360p، و 240p.

      • مطابق با معرفی ویژگی‌های cdn.frameRate و cdn.resolution منبع liveStream، cdn.format منبع اکنون منسوخ شده است. ویژگی cdn.format وضوح و نرخ فریم را در یک مقدار مشخص می‌کند.

        توصیه می‌کنیم به فیلدهای جدید پشتیبانی‌شده منتقل شوید. در این فاصله، cdn.format همچنان کار می‌کند. علاوه‌براین، درخواست‌های درج جاری‌سازی‌های زنده درحال‌حاضر تا زمانی موفقیت‌آمیز هستند که مقادیری را برای ویژگی cdn.format یا ویژگی‌های cdn.frameRate و cdn.resolution مشخص کنید. اگر برای هر سه ویژگی مقدار ارائه دهید، اگر مقادیر باهم مطابقت نداشته باشند، ممکن است API خطا برگرداند.

        توجه داشته باشید که اگرچه ویژگی cdn.format منسوخ شده است، اما اکنون از دو مقدار جدید 1440p و 1440p_hfr پشتیبانی می‌کند تا پشتیبانی API از جاری‌سازی‌های 1440p با سرعت ۳۰ یا ۶۰ فریم در ثانیه را منعکس کند.

    • liveBroadcast به‌روزرسانی منبع

      • منبع liveBroadcast حاوی ویژگی‌های جدید زیر است:

        مشخصات
        contentDetails.boundStreamLastUpdateTimeMs تاریخ و زمانی که جاری‌سازی زنده ارجاع‌شده توسط ویژگی contentDetails.boundStreamId همه‌فرستی آخرین بار به‌روزرسانی شده است.
        contentDetails.projection قالب پخش همه‌جانبه. مقدار پیش‌فرض این ویژگی rectangular است. مقادیر معتبر برای این ویژگی 360 و rectangular است.

      • تعریف ویژگی statistics.totalChatCount منبع liveBroadcast به‌روزرسانی شده است تا نشان دهد که مقدار ویژگی فقط درصورتی نشان داده می‌شود که همه‌فرستی حداقل یک پیام گپ داشته باشد.

    • liveChatMessage به‌روزرسانی منبع

      • ویژگی snippet.type از دو مقدار جدید پشتیبانی می‌کند – messageDeletedEvent و userBannedEvent – که با ویژگی‌های جدید شرح‌داده‌شده در نکته نقطه‌گلوله‌ای زیر مطابقت دارند. تعریف ویژگی snippet.authorChannelId نیز به‌روز شده است تا توضیح دهد مقدار ویژگی چه چیزی را برای این نوع پیام‌های جدید شناسایی می‌کند.

      • منبع liveChatMessage حاوی ویژگی‌های جدید زیر است:

        مشخصات
        snippet.messageDeletedDetails این شیء حاوی اطلاعاتی درباره پیامی است که توسط گرداننده گپ حذف شده است. شیء فقط درصورتی وجود دارد که مقدار ویژگی snippet.type برابر با messageDeletedEvent باشد.
        snippet.userBannedDetails این شیء حاوی اطلاعاتی درباره کاربری است که از شرکت در گپ منع شده است. این شیء همچنین حاوی اطلاعاتی درباره خود ممنوعیت است، یعنی اینکه آیا ممنوعیت دائمی است یا موقت. اگر ممنوعیت موقت باشد، یکی از ویژگی‌های شیء مدت ممنوعیت را مشخص می‌کند.

        این شیء فقط درصورتی وجود دارد که مقدار ویژگی snippet.type برابر با userBannedEvent باشد.

  • خطاهای جدید و به‌روزشده

    • این میانای برنامه‌سازی کاربردی از خطاهای جدید زیر پشتیبانی می‌کند:

      جزئیات خطا
      liveBroadcasts.bind روش liveBroadcasts.bind خطای 403 (Forbidden) را برمی‌گرداند تا نشان دهد کاربر درخواست‌های زیادی را در یک بازه زمانی مشخص ارسال کرده است. دلیل خطا userRequestsExceedRateLimit است.

      روش‌های liveBroadcasts.insert و liveBroadcasts.update ازقبل از همین خطا پشتیبانی می‌کنند.
      liveStreams.insert روش liveStreams.insert از چهار خطای جدید 400 (Bad Request) پشتیبانی می‌کند که مقدار ویژگی نامعتبر را در منبع liveStream که درخواست سعی در درج آن داشته است شناسایی می‌کند. فهرست زیر دلایل خطا و ویژگی‌های مرتبط با آن‌ها را مشخص می‌کند:
      liveStreams.insert روش liveStreams.insert از دو خطای جدید 400 (Bad Request) پشتیبانی می‌کند که هرکدام نشان می‌دهد مقدار الزامی در منبع liveStream که درخواست سعی کرده است درج کند وجود ندارد. فهرست زیر دلایل خطا و ویژگی‌های مرتبط با آن‌ها را مشخص می‌کند:
      به‌طور دقیق‌تر، وقتی منبع liveStream را درج می‌کنید، باید مقداری را برای ویژگی cdn.format یا برای ویژگی‌های cdn.frameRate و cdn.resolution مشخص کنید.
      • اگر برای هریک از این سه ویژگی مقداری مشخص نکنید، میانای برنامه‌سازی کاربردی خطای formatRequired را برمی‌گرداند.
      • اگر مقداری برای cdn.resolution مشخص کنید اما برای cdn.frameRate مشخص نکنید، API خطای frameRateRequired را برمی‌گرداند.
      • اگر مقداری برای cdn.frameRate مشخص کنید اما برای cdn.resolution مشخص نکنید، API خطای resolutionRequired را برمی‌گرداند.
      liveStreams.update اگر درخواست سعی کند مقدار هرکدام از ویژگی‌های تغییرناپذیر زیر را اصلاح کند، روش liveStreams.update خطای 403 (Forbidden) را برمی‌گرداند: reason در پاسخ خطا liveStreamModificationNotAllowed است.

‫۱۸ دسامبر ۲۰۱۵

قوانین اتحادیه اروپا (EU) ایجاب می‌کند که شفاف‌سازی‌های خاصی به کاربران نهایی در اتحادیه اروپا ارائه شود و موافقت آن‌ها کسب شود. بنابراین، برای کاربران نهایی در اتحادیه اروپا، باید از خط‌مشی رضایت کاربر اتحادیه اروپا پیروی کنید. ما اعلانی درباره این الزام در شرایط خدمات YouTube API اضافه کرده‌ایم.

۱۷ دسامبر ۲۰۱۵

این به‌روزرسانی شامل تغییرات زیر است:

  • منابع و روش‌های جدید

    • این API از چندین منبع جدید برای پشتیبانی از عملکرد گپ برای پخش‌های زنده پشتیبانی می‌کند. ‫YouTube از عملکرد گپ مستقیم درطول پخش مستقیم فعال پشتیبانی می‌کند و این منابع و روش‌های آن‌ها از بازیابی پیام‌های گپ و همچنین عملکردهای مدیریتی گپ پشتیبانی می‌کنند.

      منابع
      liveChatMessage این منبع نشان‌دهنده پیامی در گپ مستقیم YouTube است. ‫YouTube از چندین نوع پیام پشتیبانی می‌کند، ازجمله پیام‌های نوشتاری و رویدادهای «تأمین بودجه از طرفداران». برخی‌از انواع پیام‌ها مرحله خاصی از گپ را مشخص می‌کنند، مانند شروع دوره مختص حامیان مالی یا پایان گپ. این میانای برنامه‌سازی کاربردی از روش‌هایی برای فهرست کردن، درج کردن، و حذف کردن پیام‌های گپ مستقیم پشتیبانی می‌کند.
      liveChatModerators این منبع گرداننده گپ را شناسایی می‌کند. گردانندگان می‌توانند برخی‌از عملکردهای مدیریتی را انجام دهند، مانند ممنوع کردن کاربران از گپ یا حذف پیام‌ها. این میانای برنامه‌سازی کاربردی از روش‌هایی برای فهرست کردن، درج کردن، و حذف کردن گردانندگان گپ مستقیم پشتیبانی می‌کند.
      liveChatBans این منبع کاربری را شناسایی می‌کند که از ارسال پیام در یک گپ مستقیم خاص منع شده است. ممنوعیت‌ها می‌توانند موقت یا دائمی باشند. این میانای برنامه‌سازی کاربردی از روش‌هایی برای درج و حذف ممنوعیت‌های گپ مستقیم پشتیبانی می‌کند.
      fanFundingEvents این منبع نشان‌دهنده رویداد «تأمین بودجه از طرفداران» در کانال YouTube است. «تأمین بودجه از طرف طرفداران» راهی برای بینندگان فراهم می‌کند تا به‌طور داوطلبانه از «محتواسازان YouTube» با حمایت مالی یک‌باره حمایت کنند.

      روش fanFundingEvents.list میانای برنامه‌سازی کاربردی رویدادهای «تأمین بودجه ازسوی طرفداران» کانال را فهرست می‌کند. رویدادهای «تأمین بودجه طرفداران» که ازطریق گپ مستقیم درطول پخش زنده تحت مالکیت کانال آغاز می‌شوند، همچنین باعث ارسال پیام fanFundingEvent به گپ مستقیم پخش می‌شوند.

      در مرکز راهنمایی YouTube درباره «تأمین بودجه از طرف طرفداران» بیشتر بدانید.
      sponsors منبع sponsor حامی مالی کانال YouTube را شناسایی می‌کند. حامی مالی هزینه ماهانه‌ای به کانال پرداخت می‌کند. نشانی در کنار پیام‌های حامی مالی در گپ‌های مستقیم کانال نشان داده می‌شود و حامیان مالی همچنین می‌توانند در گپ‌های مستقیم منحصراً برای حامیان مالی کانال، درصورت وجود، شرکت کنند.

      روش sponsors.list میانای برنامه‌سازی کاربردی حامیان مالی کانال را فهرست می‌کند. وقتی کاربران درطول پخش مستقیم متعلق به کانال برای حمایت مالی از آن کانال ثبت‌نام می‌کنند، API همچنین یک newSponsorEvent پیام به گپ مستقیم پخش اضافه می‌کند.

      در مرکز راهنمایی YouTube درباره حمایت مالی بیشتر بدانید.

  • به‌روزرسانی‌های منابع و روش‌های موجود

    • منبع liveBroadcast حاوی ویژگی‌های جدید زیر است:

      مشخصات
      snippet.liveChatId شناسه گپ مستقیم YouTube برای پخش. با این شناسه، می‌توانید از روش‌های منبع liveChatMessage برای بازیابی، درج، یا حذف پیام‌های گپ استفاده کنید. همچنین می‌توانید گردانندگان گپ را اضافه یا حذف کنید، کاربران را از شرکت در گپ‌های زنده منع کنید، یا ممنوعیت‌های موجود را بردارید.
      contentDetails.closedCaptionsType توجه: این ویژگی جایگزین ویژگی contentDetails.enableClosedCaptions می‌شود.

      این ویژگی نشان می‌دهد که آیا زیرنویس ناشنوایان برای پخش شما فعال است یا نه و اگر فعال است، چه نوع زیرنویس ناشنوایانی ارائه می‌دهید:
      • ‫closedCaptionsDisabled: زیرنویس ناشنوایان برای پخش زنده غیرفعال است.
      • closedCaptionsHttpPost: شما زیرنویس‌ها را ازطریق HTTP POST به یک نشانی وب دریافت مرتبط با جاری‌سازی زنده خود ارسال خواهید کرد.
      • closedCaptionsEmbedded: زیرنویس ناشنوایان بااستفاده از قالب‌های EIA-608 و/یا CEA-708 در جاری‌سازی ویدیو کدبندی خواهد شد.
      contentDetails.enableClosedCaptions این ویژگی از ۱۷ دسامبر ۲۰۱۵ منسوخ شده است. به‌جای آن، از خصوصیت contentDetails.closedCaptionsType استفاده کنید. برای کارخواه‌های میانای برنامه‌سازی کاربردی که قبلاً از این ویژگی استفاده می‌کردند:
      • تنظیم مقدار خصوصیت روی true معادل تنظیم خصوصیت contentDetails.closedCaptionsType روی closedCaptionsHttpPost است.
      • تنظیم مقدار خصوصیت روی false معادل تنظیم خصوصیت contentDetails.closedCaptionsType روی closedCaptionsDisabled است.

    • پارامتر جدید broadcastType در روش liveBroadcasts.list به شما امکان می‌دهد پاسخ API را فیلتر کنید تا شامل پخش‌های رویداد، پخش‌های دائمی، یا همه پخش‌ها باشد.

      همه‌فرستی پایدار همه‌فرستی‌ای است که همیشه وجود دارد و به رویداد خاصی مرتبط نیست. به‌طور خاص، پخش پیش‌فرض کانال یک پخش مداوم است و ازطریق داشبورد جاری‌سازی زنده در «استودیوِ محتواسازان YouTube» قابل دسترسی است. سایر همه‌فرستی‌های کانال، همه‌فرستی رویداد هستند.

  • فیلد status.healthStatus.configurationIssues[].type منبع liveStream خطاهای وضعیت سلامت جدید زیر را گزارش می‌کند:

    خطاها
    audioTooManyChannels صدا بیش از دو کانال دارد، اما فقط یک (مونو) یا دو کانال (استریو) پشتیبانی می‌شود. لطفاً تعداد کانال‌های صوتی را درست کنید.
    frameRateHigh نرخ فریم کنونی خیلی بالا است. لطفاً نرخ فریم را به %(framerate)s فریم در ثانیه یا کمتر تنظیم کنید.

  • تاریخ انتشار به‌روزرسانی قبلی اسناد اصلاح شد.

  • خطاهای جدید و به‌روزشده

    • علاوه‌بر خطاهای تعریف‌شده برای منابع جدید فهرست‌شده در بالا، API از خطاهای جدید زیر پشتیبانی می‌کند:

      جزئیات خطا
      liveBroadcasts.update
      کد پاسخ HTTPforbidden (403)
      استدلالclosedCaptionsTypeModificationNotAllowed
      شرحمقدار contentDetails.closedCaptionsType فقط زمانی قابل تغییر است که همه‌فرستی در وضعیت created یا ready باشد.
      liveBroadcasts.update
      کد پاسخ HTTPinvalidValue (400)
      استدلالinvalidEnableClosedCaptions
      شرحدر منبع liveBroadcast، مقدار ویژگی contentDetails.enableClosedCaptions با مقدار تنظیم contentDetails.closedCaptionType ناسازگار است. منبع را به‌گونه‌ای اصلاح کنید که فقط یکی از این دو ویژگی را داشته باشد، سپس درخواست را دوباره ارسال کنید.

‫۱۹ اوت ۲۰۱۵

این به‌روزرسانی شامل تغییرات زیر است:

  • منابع و روش‌های جدید

    • توجه: اسناد مربوط به منبع liveChat و روش‌های آن محرمانه است و فقط برای شرکای منتخب YouTube قابل‌مشاهده است.

      منبع جدید liveChat حاوی نظری است که درطول پخش زنده در YouTube پست شده است. میانای برنامه‌سازی کاربردی از دو روش برای این منبع پشتیبانی می‌کند:

      روش‌ها
      liveChats.list فهرست کردن پیام‌های گپ مستقیم برای یک همه‌فرستی.
      liveChats.insert پیام گپ جدیدی ایجاد کنید.

      پیام‌های گپ زنده فقط زمانی قابل بازیابی و پست کردن هستند که همه‌فرستی زنده باشد.

  • به‌روزرسانی‌های منابع و روش‌های موجود

    • منبع liveStream حاوی ویژگی‌های جدید زیر است:

      مشخصات
      snippet.isDefaultStream نشان می‌دهد که آیا این جاری‌سازی، جاری‌سازی پیش‌فرض کانال است یا نه. جاری‌سازی پیش‌فرض کانال به‌طور نامحدود وجود دارد، زمان شروع یا پایان مرتبط با آن ندارد و نمی‌توان آن را حذف کرد. برای اطلاعات بیشتر درباره نحوه عملکرد جاری‌سازی‌های پیش‌فرض، تعریف دارایی را ببینید.
      status.healthStatus این شیء حاوی اطلاعاتی است که می‌تواند برای شناسایی، تشخیص، و حل مشکلات جاری‌سازی استفاده شود. این شیء حاوی تعدادی ویژگی‌های فرعی است که به شما کمک می‌کند سلامت جاری‌سازی زنده ویدیویی را ارزیابی کنید.

      به‌ویژه، شیء status.healthStatus.configurationIssues[] مشکلاتی را که بر جاری‌سازی ویدیویی تأثیر می‌گذارند فهرست می‌کند. سند جدیدی با عنوان مشکلات پیکربندی برای منابع جاری‌سازی زنده همه مشکلاتی را که API گزارش می‌کند فهرست می‌کند.
      contentDetails.isReusable نشان می‌دهد که آیا جاری‌سازی قابل‌استفاده مجدد است یا خیر، به این معنی که می‌تواند به چندین پخش متصل شود. معمولاً همه‌فرست‌ها از یک جاری‌سازی برای همه‌فرستی‌های مختلف استفاده می‌کنند، اگر آن همه‌فرستی‌ها در زمان‌های مختلفی اتفاق بیفتند.

    • منبع liveBroadcast حاوی ویژگی‌های جدید زیر است:

      مشخصات
      snippet.isDefaultBroadcast نشان می‌دهد که آیا این همه‌فرستی، همه‌فرستی پیش‌فرض کانال است یا نه. وقتی کانال YouTube برای جاری‌سازی زنده فعال می‌شود، YouTube یک جاری‌سازی پیش‌فرض و یک همه‌فرستی پیش‌فرض برای کانال ایجاد می‌کند. جاری‌سازی نحوه ارسال ویدیو زنده توسط مالک کانال به YouTube را تعریف می‌کند و همه‌فرستی نحوه مشاهده جاری‌سازی پیش‌فرض توسط بینندگان است. برای اطلاعات بیشتر درباره نحوه عملکرد همه‌فرستی‌های پیش‌فرض، تعریف دارایی را ببینید.
      contentDetails.enableLowLatency نشان می‌دهد که آیا این پخش باید برای جاری‌سازی با تأخیر کم کدبندی شود یا نه. جاری‌سازی با تأخیر کم می‌تواند مدت زمان لازم برای قابل مشاهده شدن ویدیو برای کاربرانی که پخش را تماشا می‌کنند کاهش دهد، هرچند می‌تواند بر وضوح برای بینندگان جاری‌سازی نیز تأثیر بگذارد.
      statistics.totalChatCount تعداد کل پیام‌های گپ مستقیم مرتبط با همه‌فرستی. اگر همه‌فرستی برای کاربر قابل‌مشاهده باشد و ویژگی گپ مستقیم برای آن فعال باشد، این ویژگی و مقدار آن وجود دارد. توجه داشته باشید که این ویژگی پس‌از پایان همه‌فرستی مقداری را مشخص نخواهد کرد. بنابراین، این ویژگی تعداد پیام‌های گپ را برای ویدیو بایگانی‌شده از پخش زنده تکمیل‌شده شناسایی نمی‌کند.

  • خطاهای جدید و به‌روزشده

    • علاوه‌بر خطاهای تعریف‌شده برای منبع جدید liveChat، میانای برنامه‌سازی کاربردی از خطای جدید زیر پشتیبانی می‌کند:

      جزئیات خطا
      liveStreams.update
      کد پاسخ HTTPforbidden (403)
      استدلالliveStreamModificationNotAllowed
      شرحAPI به شما اجازه نمی‌دهد که یک پخش زنده قابل‌استفاده مجدد را به غیرقابل‌استفاده مجدد تغییر دهید یا برعکس. برای اطلاعات بیشتر، به آشنایی با همه‌فرستی‌ها و جاری‌سازی‌ها مراجعه کنید

‫۲۱ مه ۲۰۱۵

این به‌روزرسانی شامل تغییرات زیر است:

  • ‫YouTube اکنون از جاری‌سازی زنده ویدیو با سرعت ۶۰ فریم در ثانیه (fps) پشتیبانی می‌کند، که به معنای بازپخش روان‌تر برای بازی‌ها و سایر ویدیوهای با حرکت سریع است. وقتی جاری‌سازی زنده را در YouTube با نرخ ۶۰ فریم در ثانیه شروع می‌کنید، YouTube جاری‌سازی را با نرخ ۳۰ فریم در ثانیه نیز در دستگاه‌هایی که تماشا با نرخ فریم بالا هنوز در آن‌ها دردسترس نیست، دردسترس قرار می‌دهد.

    ویژگی cdn.format منبع liveStream از دو مقدار جدید برای این ویژگی پشتیبانی می‌کند: 720p_hfr و 1080p_hfr.

    برای اطلاعات بیشتر درباره این ویژگی، به وبلاگ محتواسازان YouTube مراجعه کنید.

‫۲۱ اوت ۲۰۱۴

این به‌روزرسانی شامل تغییرات زیر است:

  • تعریف پارامتر walltime روش liveBroadcasts.control به‌روز شده است تا مشخص شود که مقدار ویژگی در قالب ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) تعیین شده است.

  • این میانای برنامه‌سازی کاربردی اکنون از خطاهای زیر پشتیبانی می‌کند:

    نوع خطا جزئیات خطا شرح
    insufficientPermissions liveStreamingNotEnabled اگر کاربری که درخواست API را مجاز کرده است برای جاری‌سازی ویدیو زنده در YouTube فعال نشده باشد، همه روش‌ها برای منابع liveBroadcast و liveStream این خطا را برمی‌گردانند. جزئیات توضیح‌دهنده اینکه چرا کاربر نمی‌تواند ویدیو زنده جاری‌سازی کند ممکن است در تنظیمات کانال کاربر در https://www.youtube.com/features دردسترس باشد.
    rateLimitExceeded userRequestsExceedRateLimit هر دو روش liveBroadcasts.insert و liveStreams.insert این خطا را برمی‌گردانند تا نشان دهند که کاربر درخواست‌های زیادی را در یک بازه زمانی مشخص ارسال کرده است.

۲ مه ۲۰۱۴

این به‌روزرسانی شامل تغییرات زیر است:

  • توضیحات منبع liveStream و روش liveBroadcasts.bind به‌روز شده‌اند تا نشان دهند که یک پخش فقط می‌تواند به یک جریان ویدیو محدود شود، اما یک جریان ویدیو می‌تواند به بیش از یک پخش محدود شود. این تغییر صرفاً اصلاحیه‌ای برای مستندات است؛ عملکرد API اصلی تغییر نکرده است.

  • ویژگی contentDetails.monitorStream.enableMonitorStream منبع liveBroadcast به‌روزرسانی شده است تا توضیح دهد که اگر مقدار ویژگی true باشد، باید همه‌فرستی‌تان را به حالت testing انتقال دهید تا بتوانید آن را به حالت live انتقال دهید. (اگر مقدار ویژگی false باشد، همه‌فرستی شما نمی‌تواند مرحله testing داشته باشد، بنابراین می‌توانید همه‌فرستی را مستقیماً به حالت live انتقال دهید.

  • ویژگی settings.offsetTimeMs منبع liveCuepoint به‌روز شده است تا توجه داشته باشید که اگر همه‌فرستی شما جاری‌سازی مانیتور ندارد، نباید مقداری برای این ویژگی مشخص کنید.

  • اکنون همه روش‌های منابع liveBroadcast و liveStream از پارامترهای onBehalfOfContentOwner و onBehalfOfContentOwnerChannel پشتیبانی می‌کنند. این پارامترها به شما امکان می‌دهند از همان اطلاعات اعتباری مجوز برای تکمیل درخواست‌های API برای کانال‌های مختلف مرتبط با همان مالک محتوا استفاده کنید.

  • اسناد روش liveCuepoints.insert به‌روز شده است تا نشان دهد که می‌توانید هنگام فراخوانی آن روش، مقداری برای ویژگی settings.walltime تنظیم کنید.

  • مستندات خطا اکنون کد پاسخ HTTP را برای هر نوع خطا مشخص می‌کند.

  • اکنون API از خطای زیر پشتیبانی می‌کند:

    نوع خطا جزئیات خطا شرح
    insufficientPermissions livePermissionBlocked اگر کاربری که درخواست را مجاز کرده است نتواند ویدیو زنده در YouTube جاری‌سازی کند، روش‌های liveBroadcasts.insert، liveBroadcasts.transition، و liveStreams.insert این خطا را برمی‌گردانند. جزئیات توضیح‌دهنده اینکه چرا کاربر نمی‌تواند ویدیو زنده جاری‌سازی کند ممکن است در تنظیمات کانال کاربر در https://www.youtube.com/features دردسترس باشد.

  • خطای invalidScheduledStartTime روش liveBroadcasts.insert به‌روزرسانی شده است تا روشن شود که زمان شروع زمان‌بندی‌شده باید به‌اندازه کافی به تاریخ فعلی نزدیک باشد تا بتوان همه‌فرستی را به‌طور قابل‌اعتمادی در آن زمان زمان‌بندی کرد.

‫۱۳ دسامبر ۲۰۱۳

این به‌روزرسانی شامل تغییرات زیر است:

  • ویژگی جدید status.recordingStatus منبع liveBroadcast وضعیت فعلی پخش را مشخص می‌کند.

  • ویژگی جدید contentDetails.enableClosedCaptions منبع liveBroadcast نشان می‌دهد که آیا زیرنویس ناشنوایان می‌تواند برای پخش همه‌گانی دریافت شود یا نه. مقدار ویژگی را می‌توان هنگام درج یا به‌روزرسانی یک پخش تنظیم کرد، اما پس‌از اینکه پخش در وضعیت testing یا live قرار گرفت، نمی‌توان آن را به‌روزرسانی کرد. اگر این ویژگی را روی true تنظیم کنید، منبع liveStream که به همه‌فرستی محدود شده است، نشانی وب دریافت را برای استفاده در زیرنویس ناشنوایان همه‌فرستی مشخص می‌کند.

  • ویژگی snippet.scheduledEndTime منبع liveBroadcast اکنون از همه‌فرستی‌هایی که برای ادامه نامحدود زمان‌بندی شده‌اند پشتیبانی می‌کند. با این تغییر، این ویژگی دیگر در درخواست‌های liveBroadcasts.insert و liveBroadcasts.update الزامی نیست.

    اگر منبع liveBroadcast را بازیابی کنید که مقداری برای این ویژگی مشخص نمی‌کند، پخش برای ادامه نامحدود زمان‌بندی می‌شود. به‌طور مشابه، اگر روش liveBroadcasts.insert یا liveBroadcasts.update را فراخوانی کنید و مقداری برای این ویژگی مشخص نکنید، همه‌فرستی برای ادامه نامحدود زمان‌بندی خواهد شد.

  • ویژگی contentDetails.recordFromStart منبع liveBroadcast که قبلاً مقدار پیش‌فرض true را داشت، اکنون فقط درصورتی می‌تواند روی false تنظیم شود که کانال پخش‌کننده مجاز به غیرفعال کردن ضبط برای پخش‌های زنده باشد.

    اگر کانال شما اجازه غیرفعال کردن ضبط را نداشته باشد و شما تلاش کنید یک پخش را با ویژگی recordFromStart تنظیم شده روی false درج کنید، API خطای Forbidden را برمی‌گرداند. علاوه‌براین، اگر کانال شما این اجازه را نداشته باشد و شما تلاش کنید تا یک پخش را به‌روزرسانی کنید تا ویژگی recordFromStart را به false تنظیم کنید، API خطای modificationNotAllowed را برمی‌گرداند.

  • منبع liveBroadcast دیگر حاوی ویژگی enableArchive نیست، که در شرح ویژگی‌های contentDetails.enableDvr و contentDetails.enableEmbed ذکر شده بود.

  • فهرست مقادیر معتبر برای ویژگی status.lifeCycleStatus منبع liveBroadcast به‌روزرسانی شده است تا شرح هر وضعیت را دربرگیرد.

  • ویژگی جدید settings.walltime منبع liveCuepoint تاریخ و زمانی را که نقطه نشانه باید درج شود مشخص می‌کند. اگر درخواستی سعی کند نقطه نشانه‌ای را درج کند که مقداری را برای این ویژگی و ویژگی settings.offsetTimeMs مشخص می‌کند، API خطا برمی‌گرداند.

  • شیء جدید contentDetails در منبع liveStream حاوی اطلاعاتی درباره جاری‌سازی است. درحال‌حاضر، تنها ویژگی شیء contentDetails.closedCaptionsIngestionUrl است که نشانی وب دریافت را برای زیرنویس ناشنوایان مرتبط با جاری‌سازی ویدیو مشخص می‌کند.

  • فهرست مقادیر معتبر برای ویژگی status.streamStatus منبع liveStream به‌روزرسانی شده است تا شامل شرح هر وضعیت باشد.

  • پارامتر جدید walltime در روش liveBroadcasts.control به شما امکان می‌دهد تاریخ و زمان وقوع تغییر در لوح را مشخص کنید. اگر درخواستی مقداری برای این پارامتر و پارامتر offsetTimeMs مشخص کند، API خطا می‌دهد.

  • در پاسخ میانای برنامه‌سازی کاربردی به درخواست liveBroadcasts.list، مقدار ویژگی kind از youtube#liveBroadcastList به youtube#liveBroadcastListResponse تغییر کرده است.

  • در پاسخ میانای برنامه‌سازی کاربردی به درخواست liveStreams.list، مقدار ویژگی kind از youtube#liveStreamList به youtube#liveStreamListResponse تغییر کرده است.

  • خصوصیت eventId هم از liveBroadcastListResponse و هم از liveStreamListResponse منسوخ شده است.

  • این میانای برنامه‌سازی کاربردی از خطاهای جدید زیر پشتیبانی می‌کند:

    نوع خطا جزئیات خطا شرح
    invalidValue conflictingTimeFields اگر درخواست شما مقادیری را برای پارامترهای offsetTimeMs و walltime مشخص کند، روش liveBroadcasts.control این خطا را برمی‌گرداند. درخواست می‌تواند هر دو پارامتر را حذف کند یا مقداری برای یکی از دو پارامتر مشخص کند.
    invalidValue invalidWalltime اگر مقدار پارامتر walltime نامعتبر باشد، روش liveBroadcasts.control این خطا را برمی‌گرداند.
    forbidden enableClosedCaptionsModificationNotAllowed اگر بخواهید مقدار contentDetails.enableClosedCaptions را به‌روز کنید و وضعیت همه‌فرستی created یا ready نباشد، روش liveBroadcasts.update این خطا را برمی‌گرداند.
    invalidValue conflictingTimeFields اگر درخواست شما مقادیری را برای ویژگی‌های settings.offsetTimeMs و settings.walltime مشخص کند، روش liveCuepoints.insert این خطا را برمی‌گرداند. درخواست می‌تواند هر دو ویژگی را حذف کند یا مقداری را برای یکی از دو ویژگی مشخص کند.

    علاوه‌براین، روش liveStreams.update دیگر از خطای cdnRequired مشابه خطایی که روش liveStreams.insert پشتیبانی می‌کند پشتیبانی نمی‌کند.

‫۱۰ مه ۲۰۱۳

این به‌روزرسانی شامل تغییرات زیر است:

۲ مه ۲۰۱۳

این به‌روزرسانی شامل تغییرات زیر است:

  • روش جدید liveBroadcasts.control به شما امکان می‌دهد تنظیمات نمایش را برای لوحی که در جاری‌سازی همه‌فرستی برای همه‌فرستی‌ای که ازقبل درحال انجام است نمایش داده می‌شود تغییر دهید. اگر جاری‌سازی همه‌فرستی شما تأخیر دارد، می‌توانید از این روش برای مشخص کردن زمان جبران تأخیر هنگام وقوع تغییر لوح درخواستی استفاده کنید.

  • تعاریف ویژگی‌های زیر به‌روزرسانی شده‌اند تا توضیح دهند که اگر بخش contentDetails منبع liveBroadcast را به‌روزرسانی کنید، مقادیر ویژگی باید تنظیم شوند:

  • ‫status.streamStatus منبع liveStream دیگر از مقدار deleted به‌عنوان وضعیت احتمالی جاری‌سازی پشتیبانی نمی‌کند.

  • اطلاعاتی که میانای برنامه‌سازی کاربردی برای بسیاری از پیام‌های خطا برمی‌گرداند بازبینی شده است تا دلیل وقوع خطاهای خاص بهتر توضیح داده شود. این میانای برنامه‌سازی کاربردی همچنین از چندین خطای جدید پشتیبانی می‌کند.

‫۲۷ مارس ۲۰۱۳

این به‌روزرسانی شامل تغییرات زیر است:

  • خصوصیت‌های زیر در منبع liveBroadcast تغییر کرده است:

    • نام خصوصیت startWithSlateCuepoint به startWithSlate تغییر کرده است.
    • نام خصوصیت enableArchive به recordFromStart تغییر کرده است.
    • شیء slateSettings منسوخ شده و از اسناد برداشته شده است. پیام‌های خطای مربوط به شیء slateSettings یا ویژگی‌های آن نیز برداشته شده است. درنهایت، بخش «نمایش لوح‌ها» از راهنمای شروع به کار برداشته شده است.

  • این میانای برنامه‌سازی کاربردی دیگر از قابلیت درج لوح‌های درون جاری بااستفاده از روش liveCuepoints.insert پشتیبانی نمی‌کند. اسناد زیر برای بازتاب دادن این تغییر به‌روز شده‌اند:

    • صفحه نمایه، راهنمای شروع به کار، و آموزش گام‌به‌گام عمر همه‌فرستی دیگر به این عملکرد اشاره نمی‌کنند.

    • ویژگی settings.cueType منبع liveCuepoint دیگر از slate به‌عنوان مقدار ویژگی پشتیبانی نمی‌کند. (تنها مقدار پشتیبانی‌شده ad است.

    • ویژگی settings.eventState منبع liveCuepoint منسوخ شده و از اسناد حذف شده است.

‫۱۸ مارس ۲۰۱۳

این به‌روزرسانی شامل تغییرات زیر است:

  • همه پیام‌های خطای API به‌روزرسانی شده‌اند تا خطاهای احتمالی را واضح‌تر توضیح دهند و درصورت امکان، راهنمایی‌هایی درباره نحوه رفع آن‌ها ارائه دهند.

  • اکنون ممکن است میانای برنامه‌سازی کاربردی چند خطای جدید برگرداند. فهرست زیر خطا و روش میانای برنامه‌سازی کاربردی را که ممکن است آن خطا را برگرداند مشخص می‌کند:

    • liveBroadcasts.insert – زمان پایان زمان‌بندی‌شده برای همه‌فرستی باید بعداز زمان شروع زمان‌بندی‌شده آن باشد.
    • liveBroadcasts.insert – پخش وضعیت حریم خصوصی نامعتبری را مشخص می‌کند.
    • liveBroadcasts.update – منبع حاوی مقداری برای ویژگی contentDetails.enableArchive نیست یا مقداری برای آن تنظیم نمی‌کند.
    • liveBroadcasts.update – منبع حاوی مقداری برای ویژگی contentDetails.enableContentEncryption نیست یا مقداری برای آن تنظیم نمی‌کند.
    • liveBroadcasts.update – منبع حاوی مقداری برای ویژگی contentDetails.enableDvr نیست یا مقداری برای آن تنظیم نمی‌کند.
    • liveStreams.insert – عنوان قطعه باید بین ۱ تا ۱۲۸ نویسه داشته باشد.
    • liveStreams.update – منبع حاوی مقداری برای ویژگی snippet.title نیست یا مقداری برای آن تنظیم نمی‌کند.

  • اسناد منبع liveStream به‌روزرسانی شده است تا نشان دهد که چندپخشی و WebM روش‌های انتقال پشتیبانی‌شده نیستند، همان‌طور که قبلاً اشاره شده بود. فهرست قالب‌های ویژگی cdn.format به‌طور مقتضی به‌روزرسانی شده است و شیء cdn.multicastIngestionInfo و ویژگی‌های فرزند آن از اسناد منبع برداشته شده‌اند. علاوه‌براین، http از فهرست مقادیر cdn.ingestionType پشتیبانی‌شده برداشته شده است.