سابقه بازبینی

این صفحه تغییرات YouTube Data API (نسخه ۳) و به‌روزرسانی‌های اسناد را فهرست می‌کند.

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

ویدیوهای بارگذاری‌شده ازطریق روش videos.insert از پروژه‌های API تأییدنشده دیگر به حالت مشاهده خصوصی محدود نیستند. این تغییر خط‌مشی اعلام‌شده در ۲۸ ژوئیه ۲۰۲۰ را لغو می‌کند. طبق آن خط‌مشی، ویدیوهای بارگذاری‌شده از پروژه‌های میانای برنامه‌سازی کاربردی تأییدنشده که پس‌از آن تاریخ ایجاد شده بودند تا زمان تکمیل ممیزی پروژه به حالت مشاهده خصوصی محدود می‌شدند.

اگر مقداری برای ویژگی status.privacyStatus در درخواست videos.insert مشخص نکنید، وضعیت حریم خصوصی ویدیو بارگذاری‌شده به‌طور پیش‌فرض روی public تنظیم می‌شود. همان‌طور که در مرکز راهنمایی YouTube توضیح داده شده است، برخی‌از بارگذاری‌ها ممکن است براساس تنظیمات حساب محتواساز به‌طور پیش‌فرض روی private تنظیم شوند.

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

روش videos.list شفاف‌سازی شده است تا مشخص شود که ویژگی‌های status.selfDeclaredMadeForKids و status.madeForKids فقط درصورتی به‌روزرسانی می‌شوند که در درخواست مشخص شده باشند و درصورت حذف شدن، لغو نمی‌شوند.

‫۳۰ سپتامبر ۲۰۲۶

تعریف منبع comments به‌روزرسانی شده است تا ویژگی جدید snippet.imageUrl را دربرگیرد که نشانی وب تصویر یا گیف پویانمایی‌شده پیوست‌شده به نظر را ارائه می‌دهد.

این ویژگی در نوامبر ۲۰۲۶ برای همه کاربران دردسترس خواهد بود.

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

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

  • شرح روش thumbnails.set به‌روزرسانی شده است تا نشان دهد که حداکثر اندازه فایل برای ریزعکس‌های بارگذاری‌شده از ۲ مگابایت به ۵۰ مگابایت افزایش یافته است.
  • شرح روش playlistImages.insert به‌روز شده است تا نشان دهد حداکثر اندازه فایل برای تصاویر بارگذاری‌شده از ۲ مگابایت به ۵۰ مگابایت افزایش یافته است.

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

تعریف ویژگی snippet.thumbnails.(key) در اسناد مرجع برای منابع activities، liveBroadcasts، playlistItems، playlists، search، و videos به‌روزرسانی شده است تا نشان دهد که اندازه‌های ریزعکس با وضوح بالاتر اکنون برای برخی ویدیوها دردسترس است: fhd (۱۰۸۰ پیکسل)، qhd (۱۴۴۰ پیکسل)، و uhd (4K).

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

روش videos.getRating اکنون دامنه مجوز https://www.googleapis.com/auth/youtube.readonly را می‌پذیرد.

‫۲۷ اوت ۲۰۲۶

‫YouTube شمارش بازدیدهای عمومی را برای همه قالب‌های ویدیو همسو خواهد کرد: ویدیوهای طولانی، «زنده»، و «کوته‌ویدیوها». YouTube بازدیدهای عمومی را از لحظه‌ای که پخش ویدیو شروع می‌شود محاسبه خواهد کرد.

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

هیچ تغییری در واجدشرایط بودن برای «برنامه شریک YouTube» ایجاد نشده است. شرایط ورود به «برنامه شریک YouTube» نیز ازاین‌پس با عنوان «بازدیدهای واجدشرایط کوته‌ویدیوها» و «ساعات تماشای واجدشرایط» (قبلاً «بازدیدهای عمومی معتبر کوته‌ویدیوها» و «ساعات تماشای عمومی معتبر») شناخته خواهد شد.

برای کسب اطلاعات بیشتر، آشنایی با عملکرد محتوا در YouTube را ببینید.

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

به‌روزرسانی‌های اسناد API: شرح فیلد viewCount در اسناد مرجع کانال‌ها و ویدیوها به‌روزرسانی شد.

‫۶ اوت ۲۰۲۶

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

  • همه ارجاع‌ها به فیلدهای contentDetails.like و contentDetails.favorite در بخش activities.contentDetails از اسناد عمومی برداشته شده‌اند زیرا این فیلدها توسط API برگردانده نمی‌شوند.

‫۷ ژوئیه ۲۰۲۶

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

اکنون API از بخش brandPartner در منبع videos پشتیبانی می‌کند. این بخش حاوی جزئیات مربوط به نمانام شریک پیوندشده به ویدیو برای دسترسی نمانام شریک آغازشده ازسوی محتواساز است.

بخش brandPartner را می‌توان هنگام فراخوانی روش‌های زیر مشخص کرد:

شیء brandPartner حاوی فیلدهای زیر است:

  • ‫channelId: شناسه کانال خارجی نمانام شریک.
  • ‫channelHandle: نام کاربری کانال نمانام شریک.
هنگام ایجاد پیوند، باید channelId یا channelHandle تنظیم شود، اما فقط channelId در پاسخ برگردانده می‌شود.

‫۲۳ ژوئن ۲۰۲۶

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

  • همه ارجاع‌ها به انواع منبع messageDeletedEvent و messageRetractedEvent (و اشیاء messageDeletedDetails و messageRetractedDetails مربوطه آن‌ها) در liveChatMessages برداشته شده‌اند زیرا این رویدادها توسط API برگردانده نمی‌شوند.

‫۳ ژوئن ۲۰۲۶

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

اکنون API از روش جدیدی به نام videos.batchGetStats پشتیبانی می‌کند که فهرستی از آمار ویدیو را که با پارامترهای درخواست API مطابقت دارد بازیابی می‌کند.

تماس با این روش دارای هزینه سهمیه ۱ واحد در سطل سهمیه دانه‌ای خود است. سهمیه پیش‌فرض این روش ۱۰٬۰۰۰ واحد در روز است.

‫۱ ژوئن ۲۰۲۶

YouTube Data API درحال انتقال به سیستم سهمیه دانه‌ای است که مجموعه‌های کوچک‌تری از روش‌ها را پوشش می‌دهد، که با videos.insert و search.list شروع می‌شود.

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

فراخوانی‌های میانای برنامه‌سازی کاربردی به روش‌های videos.insert و search.list از سهمیه مربوط به خودشان کسر خواهد شد. هزینه فراخوانی‌های میانای برنامه‌سازی کاربردی برای همه روش‌های دیگر از سهمیه موجود کسر خواهد شد. توسعه‌دهندگان می‌توانند محدودیت‌های سهمیه را در کنسول Google Cloud مشاهده کنند و می‌توانند ازطریق فرم تمدید سهمیه درخواست سهمیه اضافی کنند.

‫۴ دسامبر ۲۰۲۵

سند YouTube Data API و ماشین‌حساب سهمیه به‌روزرسانی شده‌اند تا تغییر هزینه سهمیه بارگذاری ویدیو را از تقریباً ۱۶۰۰ واحد به تقریباً ۱۰۰ واحد نشان دهند.

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

از ۲۱ ژوئیه ۲۰۲۵، YouTube محتوایی را که توسط نمودار mostPopular روش video.list برگردانده می‌شود اصلاح خواهد کرد. در گذشته، نمودار mostPopular ویدیوهای ویژه در فهرست «اکنون پرطرفدار» را نشان می‌داد. اکنون، جدول mostPopular ویدیوهایی از جدول‌های «موسیقی پرطرفدار»، «فیلم‌ها»، و «بازی» را نمایش خواهد داد. این تغییر API هم‌زمان با منسوخ شدن صفحه پرطرفدار YouTube است.

‫۲۶ مارس ۲۰۲۵

از ۳۱ مارس ۲۰۲۵، YouTube نحوه شمارش بازدیدهای «کوته‌ویدیوها» را تغییر خواهد داد. در گذشته، برای «کوته‌ویدیوها»، بازدید پس‌از پخش «کوته‌ویدیو» برای تعداد ثانیه‌های مشخصی شمارش می‌شد. اکنون بازدیدها برابر با تعداد دفعاتی خواهد بود که پخش یا بازپخش «کوته‌ویدیو» شما شروع می‌شود و حداقلی برای زمان تماشا وجود نخواهد داشت. بیشتر بدانید

از ۳۱ مارس ۲۰۲۵، فیلدهای زیر در Data API شمار بازدید «کوته‌ویدیوها» را براساس این تغییر برمی‌گردانند:

  • channels.statistics.viewCount
  • videos.statistics.viewCount

‫۳۰ اکتبر ۲۰۲۴

اکنون API از توانایی شناسایی ویدیوهایی که حاوی محتوای واقع‌گرایانه تغییریافته یا مصنوعی (A/S) هستند پشتیبانی می‌کند. درباره خط‌مشی‌های YouTube مربوط به محتوای خودکشی و خودآزاری بیشتر بدانید.

نمونه‌هایی از محتوای خودآزاری شامل ویدیوهایی است که:

  • باعث می‌شود به‌نظر برسد که فردی واقعی چیزی را می‌گوید یا کاری را انجام می‌دهد که آن را نگفته یا انجام نداده است
  • تغییر دادن فیلم یک مکان یا رویداد واقعی
  • تولید کردن صحنه‌ای که واقعی به‌نظر می‌رسد اما درواقع اتفاق نیفتاده است

برای نشان دادن اینکه ویدیو حاوی محتوای مصنوعی یا تغییریافته است، ویژگی status.containsSyntheticMedia را تنظیم کنید. این ویژگی را می‌توان هنگام فراخوانی روش‌های videos.insert یا videos.update تنظیم کرد. اگر تنظیم شود، ویژگی در منبع video برگردانده می‌شود.

‫۳۰ آوریل ۲۰۲۴

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

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

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

‫۱۳ مارس ۲۰۲۴

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

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

پارامتر sync برای روش‌های captions.insert و captions.update منسوخ شده است. ‫YouTube از ۱۲ آوریل ۲۰۲۴ پشتیبانی از پارامتر را متوقف خواهد کرد.

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

‫۱۲ مارس ۲۰۲۴

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

اسناد منبع captions به‌روزرسانی شده است تا نشان دهد حداکثر طول مجاز برای فیلد snippet.name ۱۵۰ نویسه است. اگر نام دسته هدف طولانی‌تر از آن باشد، API خطای nameTooLong را برمی‌گرداند.

۷ مارس ۲۰۲۴

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

خصوصیت منبع channel brandingSettings.channel.moderateComments منسوخ شده است. ‫YouTube از ۷ مارس ۲۰۲۴ دیگر از این پارامتر پشتیبانی نخواهد کرد.

‫۳۱ ژانویه ۲۰۲۴

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

پارامتر جدید forHandle در روش channels.list به شما امکان می‌دهد با مشخص کردن نام کاربری YouTube یک کانال، اطلاعات مربوط به آن را بازیابی کنید.

‫۹ نوامبر ۲۰۲۳

همه ارجاع‌ها به منبع videoId تحت Comments برداشته شده است زیرا منبع videoId بااستفاده از فراخوانی میانای برنامه‌سازی کاربردی برگردانده نمی‌شود.

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

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

روش comments.markAsSpam چندین سال است که منسوخ شده است. این روش درحال‌حاضر در YouTube پشتیبانی نمی‌شود و دیگر ازطریق API پشتیبانی نمی‌شود.

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

۲۲ اوت ۲۰۲۳

روش search.list اکنون از پارامتر videoPaidProductPlacement پشتیبانی می‌کند. این پارامتر به شما امکان می‌دهد نتایج جستجو را فیلتر کنید تا فقط ویدیوهایی را شامل شود که محتواساز آن‌ها را به‌عنوان عرضه ترویجی پولی مشخص کرده است.

‫۱۸ اوت ۲۰۲۳

تعریف liveStreamingDetails.concurrentViewers منبع video به‌روزرسانی شده است تا اشاره کند که تعداد بینندگان هم‌زمان که YouTube Data API برمی‌گرداند ممکن است با تعداد بینندگان هم‌زمان پردازش‌شده و بدون هرزنامه که ازطریق YouTube Analytics دردسترس است متفاوت باشد. مرکز راهنمایی YouTube اطلاعات بیشتری درباره سنجه‌های جاری‌سازی زنده ارائه می‌دهد.

‫۷ اوت ۲۰۲۳

همان‌طور که در ۱۲ ژوئن ۲۰۲۳ اعلام شد، پارامتر relatedToVideoId روش search.list منسوخ شده است. آن پارامتر دیگر پشتیبانی نمی‌شود و ارجاع‌ها به آن پارامتر از اسناد API برداشته شده است.

‫۲۸ ژوئن ۲۰۲۳

روش thumbnails.set اکنون از خطای uploadRateLimitExceeded پشتیبانی می‌کند که نشان می‌دهد کانال در ۲۴ ساعت گذشته تعداد زیادی ریزعکس بارگذاری کرده است و باید بعداً دوباره امتحان کند.

۱۲ ژوئن ۲۰۲۳

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

پارامتر relatedToVideoId روش search.list منسوخ شده است. YouTube از ۷ اوت ۲۰۲۳ پشتیبانی از پارامتر را متوقف خواهد کرد.

درحال‌حاضر، اعلان منسوخ شدن به مستندات روش search.list اضافه شده است. این پارامتر در تاریخ ۷ اوت ۲۰۲۳ یا پس‌از آن به‌طور کامل از اسناد search.list برداشته خواهد شد.

علاوه‌براین، نمونه‌ای که نحوه بازیابی ویدیوهای مرتبط را نشان می‌دهد از راهنمای پیاده‌سازی API برداشته شده است.

‫۲۲ اوت ۲۰۲۲

حاشیه‌نویسی‌های نوع برای فیلدهای video.statistics از unsigned long به رشته اصلاح شد.

۵ اوت ۲۰۲۲

‫YouTube روش تولید شناسه‌های زیرنویس ناشنوایان را تغییر داده است و به‌عنوان بخشی از این تغییر، شناسه‌های زیرنویس ناشنوایان جدیدی را به همه قطعه‌های زیرنویس ناشنوایان اختصاص می‌دهد. این تغییر ممکن است برای برنامه‌هایی که مقادیر caption_id را ذخیره می‌کنند، تغییری ناسازگار با نسخه‌های قبلی باشد، هرچند بر برنامه‌هایی که مقادیر caption_id را ذخیره نمی‌کنند تأثیری نخواهد داشت.

از حالا تا ۱ دسامبر ۲۰۲۲، روش‌های captions.list، captions.update، captions.download، و captions.delete از هر دو شناسه قطعه زیرنویس قدیمی و جدید پشتیبانی خواهند کرد. اما از ۱ دسامبر ۲۰۲۲، YouTube دیگر از شناسه‌های قدیمی قطعه زیرنویس ناشنوایان پشتیبانی نخواهد کرد. در آن زمان، فراخوانی هرکدام از آن روش‌های API با شناسه قطعه زیرنویس ناشنوایان قدیمی منجر به خطای captionNotFound خواهد شد.

برای آماده شدن برای این تغییر، باید برنامه‌ریزی کنید که از حالا تا ۱ دسامبر ۲۰۲۲، همه داده‌های قطعه زیرنویس ناشنوایان ذخیره‌شده را به‌طور کامل جایگزین کنید. این یعنی برای هر ویدیویی که داده‌های قطعه زیرنویس ناشنوایان آن را ذخیره می‌کنید، باید داده‌های ذخیره‌شده فعلی را حذف کنید، سپس روش captions.list را فراخوانی کنید تا مجموعه فعلی قطعه‌های زیرنویس ناشنوایان را برای ویدیو بازیابی کنید و داده‌ها را در پاسخ میانای برنامه‌سازی کاربردی به‌صورت معمول ذخیره کنید.

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

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

‫۲۷ آوریل ۲۰۲۲

شرح روش videos.insert به‌روزرسانی شده است تا نشان دهد حداکثر اندازه فایل برای ویدیوهای بارگذاری‌شده از ۱۲۸ گیگابایت به ۲۵۶ گیگابایت افزایش یافته است.

‫۸ آوریل ۲۰۲۲

تعاریف پارامترهای myRecentSubscribers و mySubscribers در روش subscriptions.list به‌روزرسانی شده‌اند تا نشان دهند که حداکثر تعداد مشترکین برگردانده‌شده توسط API ممکن است محدود باشد. این تغییر نشان‌دهنده اصلاح مستندات است و تغییری در رفتار میانای برنامه‌سازی کاربردی نیست.

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

همان‌طور که در ۱۸ نوامبر ۲۰۲۱ اعلام شد، در ارتباط با تغییرات اعمال‌شده برای خصوصی کردن تعداد نپسندیدن‌های ویدیو در کل پلتفرم YouTube، ویژگی statistics.dislikeCount منبع video اکنون خصوصی است.

می‌توانید درباره این تغییر در وبلاگ رسمی YouTube بیشتر بدانید.

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

در ارتباط با تغییرات خصوصی کردن تعداد نپسندیدن‌های ویدیو در کل پلاتفرم YouTube، ویژگی statistics.dislikeCount منبع video از ۱۳ دسامبر ۲۰۲۱ خصوصی خواهد شد. این یعنی این ویژگی فقط درصورتی در پاسخ میانای برنامه‌سازی کاربردی از نقطه پایانی videos.list گنجانده می‌شود که درخواست میانای برنامه‌سازی کاربردی توسط مالک ویدیو اصالت‌سنجی شده باشد.

نقطه پایانی videos.rate تحت‌تأثیر این تغییر قرار نمی‌گیرد.

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

می‌توانید درباره این تغییر در وبلاگ رسمی YouTube بیشتر بدانید.

‫۲ ژوئیه ۲۰۲۱

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

نقطه پایانی commentThreads.update منسوخ شده است و دیگر پشتیبانی نمی‌شود. این نقطه پایانی عملکردی را که ازطریق نقاط پایانی دیگر میانای برنامه‌سازی کاربردی دردسترس بود تکرار می‌کرد. درعوض می‌توانید با comments.update تماس بگیرید

استفاده کنید و اگر کدتان به منبع commentThreads نیاز دارد، تماس ثانویه‌ای با روش commentThreads.list برقرار کنید.

‫۱ ژوئیه ۲۰۲۱

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

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

  • فرم تمدید سهمیه و ممیزی: توسعه‌دهندگانی که قبلاً «ممیزی رعایت خط‌مشی API» را گذرانده‌اند می‌توانند این فرم را تکمیل و ارسال کنند (با انتخاب «تکمیل ممیزی رعایت خط‌مشی برای حفظ سهمیه فعلی (درخواست تکمیل ممیزی مجدد)» در سؤال اول) تا برای تمدید سهمیه اختصاص‌یافته درخواست دهند.
  • فرم پژوهش‌خواهی: توسعه‌دهندگانی که پروژه‌های API آن‌ها در ممیزی رعایت مقررات رد شده است (یا درخواست افزایش واحد سهمیه آن‌ها رد شده است) می‌توانند این فرم را تکمیل و ارسال کنند.
  • فرم تغییر کنترل: توسعه‌دهندگان، یا هر طرفی که کارخواه میانای برنامه‌سازی کاربردی را ازطرف توسعه‌دهنده اداره می‌کند، که تغییر کنترل (برای مثال، ازطریق خرید یا فروش سهام، ادغام، یا شکل دیگری از تراکنش شرکتی) مرتبط با پروژه میانای برنامه‌سازی کاربردی را تجربه می‌کند باید این فرم را تکمیل و ارسال کند. این کار به تیم میانای برنامه‌سازی کاربردی YouTube امکان می‌دهد سوابق ما را به‌روز کند، مطابقت مورد استفاده پروژه میانای برنامه‌سازی کاربردی جدید را ممیزی کند، و تخصیص سهمیه فعلی توسعه‌دهنده را اعتبارسنجی کند.

هر فرم جدید ما را از کاربرد موردنظرتان برای YouTube API مطلع می‌کند و به ما امکان می‌دهد بهتر به شما کمک کنیم.

جزئیات بیشتر در راهنمای جدید «بازرسی‌های رعایت میانای برنامه‌سازی کاربردی» ما دردسترس است.

‫۱۲ مه ۲۰۲۱

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

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

  • خصوصیت contentDetails.relatedPlaylists.favorites منبع channel منسوخ شده است. همان‌طور که در ورودی سابقه بازبینی ۲۸ آوریل ۲۰۱۶ ذکر شده است، عملکرد ویدیوهای دلخواه از چند سال پیش منسوخ شده است.

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

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

    • brandingSettings.channel.defaultTab
    • brandingSettings.channel.featuredChannelsTitle
    • brandingSettings.channel.featuredChannelsUrls[]
    • brandingSettings.channel.profileColor
    • brandingSettings.channel.showBrowseView
    • brandingSettings.channel.showRelatedChannels

    همه دارایی‌ها از channel نمایش منبع برداشته شده‌اند و تعاریف آن‌ها از فهرست دارایی منبع برداشته شده‌اند. علاوه‌براین، خطاهای مرتبط با این ویژگی‌ها از اسناد مختص روش برداشته شده است.

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

    • snippet.style
    • snippet.defaultLanguage
    • snippet.localized.title
    • localizations
    • localizations.(key)
    • localizations.(key).title
    • targeting
    • targeting.languages[]
    • targeting.regions[]
    • targeting.countries[]

    در ارتباط با این تغییر، پارامتر hl روش channelSection.list نیز منسوخ شده است زیرا ویژگی‌هایی که پشتیبانی می‌کند دیگر پشتیبانی نمی‌شوند.

    همه دارایی‌ها از channelSection نمایش منبع برداشته شده‌اند و تعاریف آن‌ها از فهرست دارایی منبع برداشته شده‌اند. علاوه‌براین، خطاهای مرتبط با این ویژگی‌ها از اسناد مختص روش برداشته شده است.

  • برای ویژگی snippet.type منبع channelSection، مقادیر زیر منسوخ شده‌اند. این مقادیر درحال‌حاضر در صفحه‌های کانال YouTube پشتیبانی نمی‌شوند و درنتیجه، دیگر ازطریق API نیز پشتیبانی نمی‌شوند.

    • likedPlaylists
    • likes
    • postedPlaylists
    • postedVideos
    • recentActivity
    • recentPosts

  • خصوصیت snippet.tags[] منبع playlist منسوخ شده است. این ویژگی دیگر در YouTube پشتیبانی نمی‌شود و درنتیجه، دیگر ازطریق API پشتیبانی نمی‌شود.

۹ فوریه ۲۰۲۱

منبع playlistItem از دو ویژگی جدید پشتیبانی می‌کند:

  • ویژگی snippet.videoOwnerChannelId شناسه کانالی را که ویدیو فهرست پخش را بارگذاری کرده است، مشخص می‌کند.
  • ویژگی snippet.videoOwnerChannelTitle نام کانالی را که ویدیو فهرست پخش را بارگذاری کرده است مشخص می‌کند.

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

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

  • روش‌های playlistItems.delete، playlistItems.insert، playlistItems.list، playlistItems.update، playlists.delete، playlists.list، و playlists.update همگی از خطای جدید playlistOperationUnsupported پشتیبانی می‌کنند. این خطا زمانی رخ می‌دهد که درخواستی تلاش می‌کند عملیاتی را انجام دهد که برای یک فهرست پخش خاص مجاز نیست. برای مثال، کاربر نمی‌تواند ویدیویی را از فهرست پخش ویدیوهای بارگذاری‌شده‌اش حذف کند یا خود فهرست پخش را حذف کند.

    در همه موارد، این خطا کد پاسخ HTTP 400 (درخواست بد) را برمی‌گرداند.

  • خطاهای watchHistoryNotAccessible و watchLaterNotAccessible روش playlistItems.list از اسناد برداشته شده است. درحالی‌که فهرست‌های تماشا در فرصتی دیگر و سابقه تماشای کاربران، درواقع، ازطریق API قابل‌دسترسی نیستند، این خطاهای خاص توسط API برگردانده نمی‌شوند.

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

دو بخش جدید به خط‌مشی‌های توسعه‌دهنده اضافه شده است:

  • بخش III.E.4.i جدید اطلاعات بیشتری درباره داده‌های جمع‌آوری‌شده و ارسال‌شده ازطریق پخش‌کننده جاسازی‌شده YouTube ارائه می‌دهد. مسئولیت هرگونه داده کاربری که ازطریق هر پخش‌کننده جاسازی‌شده YouTube برای ما ارسال می‌کنید، قبل‌از اینکه کاربر با پخش‌کننده تعامل داشته باشد تا قصد پخش را نشان دهد، برعهده شما است. با تنظیم «پخش خودکار» روی false، می‌توانید داده‌های هم‌رسانی‌شده با YouTube را قبل‌از تعامل کاربر با پخش‌کننده محدود کنید.
  • بخش III.E.4.j جدید مربوط به بررسی وضعیت «ساخته‌شده برای کودکان» (MFK) محتوا قبل‌از جاسازی آن در سایت‌ها و برنامه‌های شما است. شما مسئول هستید که بدانید ویدیوهایی که در «کارخواه API» خود جاسازی می‌کنید چه زمانی برای کودکان ساخته شده‌اند و با داده‌های جمع‌آوری‌شده از پخش‌کننده جاسازی‌شده مطابق با آن رفتار کنید. بنابراین، باید وضعیت محتوا را بااستفاده از سرویس YouTube Data API بررسی کنید و سپس آن را ازطریق هر پخش‌کننده جاسازی‌شده YouTube در کارخواه میانای برنامه‌سازی کاربردی خود جاسازی کنید.

راهنمای جدید یافتن وضعیت «ساخته‌شده برای کودکان» ویدیو توضیح می‌دهد که چگونه وضعیت «ساخته‌شده برای کودکان» ویدیو را بااستفاده از سرویس YouTube Data API جستجو کنید.

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

‫۸ اکتبر ۲۰۲۰

این به‌روزرسانی شامل سه تغییر کوچک مربوط به منبع channel است:

  • شیء snippet.thumbnails که تصاویر کوچک کانال را شناسایی می‌کند، ممکن است برای کانال‌های تازه ایجادشده خالی باشد و ممکن است تا یک روز طول بکشد تا پر شود.
  • ویژگی statistics.videoCount فقط تعداد ویدیوهای عمومی کانال را نشان می‌دهد، حتی برای مالکان. این رفتار با تعداد نشان‌داده‌شده در وب‌سایت YouTube مطابقت دارد.
  • کلیدواژه‌های کانال که در ویژگی brandingSettings.channel.keywords شناسایی می‌شوند، اگر از حداکثر طول مجاز ۵۰۰ نویسه فراتر روند یا اگر حاوی علامت‌های نقل‌قول بدون گریز (") باشند، ممکن است کوتاه شوند. توجه داشته باشید که حد ۵۰۰ نویسه حدی برای هر کلیدواژه نیست، بلکه حدی برای طول کل همه کلیدواژه‌ها است. این رفتار با رفتار در وب‌سایت YouTube مطابقت دارد.

‫۹ سپتامبر ۲۰۲۰ (۱۹ شهریور ۱۳۹۹)

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

این به‌روزرسانی تغییرات میانای برنامه‌سازی کاربردی زیر را پوشش می‌دهد. همه تغییرات از ۹ سپتامبر ۲۰۲۰، تاریخ این اعلامیه، یا پس‌از آن اعمال خواهد شد. با درنظر گرفتن این موضوع، توسعه‌دهندگان دیگر نباید به هیچ‌یک از ویژگی‌های میانای برنامه‌سازی کاربردی فهرست‌شده در زیر متکی باشند.

  • منابع، روش‌ها، پارامترها، و ویژگی‌های منبع میانای برنامه‌سازی کاربردی زیر فوراً منسوخ می‌شوند و در تاریخ این اعلامیه یا پس‌از آن ازکار خواهند افتاد:
    • ویژگی‌های منبع channel زیر:
      • مشخصه statistics.commentCount
      • شیء brandingSettings.image و همه ویژگی‌های فرزند آن
      • فهرست brandingSettings.hints و همه دارایی‌های فرزند آن
    • پارامتر فیلتر categoryId روش channels.list
    • منبع guideCategories و روش guideCategories.list
  • اگر درخواست میانای برنامه‌سازی کاربردی پارامتر managedByMe را روی true تنظیم کند، پاسخ‌های میانای برنامه‌سازی کاربردی برای روش channels.list دیگر حاوی ویژگی prevPageToken نخواهد بود. این تغییر بر ویژگی prevPageToken برای دیگر درخواست‌های channels.list تأثیری ندارد و بر ویژگی nextPageToken برای هیچ درخواستی تأثیر نمی‌گذارد.
  • ویژگی‌های contentDetails.relatedPlaylists.watchLater و contentDetails.relatedPlaylists.watchHistory منبع channel هر دو در تاریخ ۱۱ اوت ۲۰۱۶ به‌عنوان منسوخ اعلام شدند. پشتیبانی روش playlistItems.insert و روش playlistItems.delete برای این فهرست‌های پخش نیز اکنون کاملاً منسوخ شده است و این دو ویژگی از اسناد حذف شده‌اند.
  • پارامتر mySubscribers روش channels.list که در ۳۰ ژوئیه ۲۰۱۳ به‌عنوان منسوخ‌شده اعلام شده بود، از اسناد حذف شده است. از روش subscriptions.list و پارامتر mySubscribers آن برای بازیابی فهرست مشترکین کانال کاربر اصالت‌سنجی‌شده استفاده کنید.
  • شیء invideoPromotion منبع channel و همه ویژگی‌های فرزند آن که در ۲۷ نوامبر ۲۰۱۷ به‌عنوان منسوخ‌شده اعلام شده بودند، از اسناد حذف شده‌اند.

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

فرایند کسر سهمیه برای درخواست‌های API را با حذف هزینه اضافی مرتبط با پارامتر part ساده کرده‌ایم. از همین حالا، فقط هزینه پایه را برای روشی که فراخوانی می‌شود کسر می‌کنیم. در اینجا می‌توانید اطلاعات بیشتری درباره سهمیه ساده‌شده کسب کنید.

تأثیر این تغییر این است که اکثر فراخوانی‌های میانای برنامه‌سازی کاربردی هزینه سهمیه کمی پایین‌تر خواهند داشت، درحالی‌که برخی‌از فراخوانی‌های میانای برنامه‌سازی کاربردی همچنان هزینه یکسانی خواهند داشت. این تغییر هزینه هیچ‌یک از تماس‌های میانای برنامه‌سازی کاربردی را افزایش نمی‌دهد. به‌طورکلی، تأثیر احتمالی این است که سهمیه اختصاص‌داده‌شده به شما، که در کنسول Google Cloud قابل‌مشاهده است، کمی بیشتر خواهد شد.

قویاً توصیه می‌کنیم که همه توسعه‌دهندگان برای پروژه‌هایشان ممیزی رعایت مقررات انجام دهند تا از دسترسی مداوم به «سرویس‌های YouTube API» مطمئن شوند.

این ورودی سابقه ویرایش در ابتدا در ۲۰ ژوئیه ۲۰۲۰ منتشر شده است.

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

همه ویدیوهای بارگذاری‌شده ازطریق نقطه پایانی videos.insert از پروژه‌های API تأییدنشده که پس‌از ۲۸ ژوئیه ۲۰۲۰ ایجاد شده‌اند، به حالت مشاهده خصوصی محدود خواهند شد. برای برداشتن این محدودیت، هر پروژه باید ممیزی شود تا مطابقت آن با شرایط خدمات درستی‌سنجی شود.

محتواسازانی که از کارخواه API تأییدنشده برای بارگذاری ویدیو استفاده می‌کنند ایمیلی دریافت خواهند کرد که توضیح می‌دهد ویدیو آن‌ها به‌عنوان «خصوصی» قفل شده است و می‌توانند بااستفاده از کارخواه رسمی یا حسابرسی‌شده از این محدودیت اجتناب کنند.

پروژه‌های API ایجادشده قبل‌از ۲۸ ژوئیه ۲۰۲۰ درحال‌حاضر تحت تأثیر این تغییر قرار نمی‌گیرند. بااین‌حال، قویاً توصیه می‌کنیم که همه توسعه‌دهندگان ممیزی رعایت مقررات را برای پروژه‌هایشان تکمیل کنند تا مطمئن شوند که دسترسی‌شان به «سرویس‌های YouTube API» ادامه خواهد داشت.

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

[به‌روزرسانی‌شده در ۲۸ ژوئیه ۲۰۲۰.] به‌روزرسانی اسناد ارجاع‌شده در این ورودی سابقه بازبینی در ۲۸ ژوئیه ۲۰۲۰ بازنشر شد.

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

‫۷ ژوئیه ۲۰۲۰

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

پارامترهای autoLevels و stabilize روش videos.insert اکنون منسوخ شده‌اند و هر دو پارامتر از اسناد حذف شده‌اند. مقادیر آن‌ها نادیده گرفته می‌شود و بر نحوه پردازش ویدیوهای جدید بارگذاری‌شده تأثیری ندارد.

۱۵ ژوئن ۲۰۲۰

راهنمای جدید رعایت خط‌مشی‌های توسعه‌دهنده YouTube راهنمایی‌ها و نمونه‌هایی را ارائه می‌دهد تا به شما کمک کند مطمئن شوید که کارخواه‌های میانای برنامه‌سازی کاربردی شما از بخش‌های خاصی از شرایط و خط‌مشی‌های سرویس‌های YouTube API (شرایط خدمات میانای برنامه‌سازی کاربردی) پیروی می‌کنند.

این راهنما بینشی درباره نحوه اجرای برخی جنبه‌های «شرایط خدمات میانای برنامه‌سازی کاربردی» توسط YouTube ارائه می‌دهد اما جایگزین هیچ‌یک از اسناد موجود نمی‌شود. این راهنما به برخی‌از رایج‌ترین سؤالاتی که توسعه‌دهندگان درطول ممیزی‌های رعایت میانای برنامه‌سازی کاربردی می‌پرسند پاسخ می‌دهد. امیدواریم این راهنما با کمک به شما در درک نحوه تفسیر و اجرای خط‌مشی‌هایمان، فرایند توسعه ویژگی را برایتان ساده‌تر کند.

۴ ژوئن ۲۰۲۰

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

ویژگی بولتن کانال اکنون کاملاً منسوخ شده است. این تغییر ابتدا در ۱۷ آوریل ۲۰۲۰ اعلام شد و اکنون اعمال شده است. درنتیجه، روش activities.insert دیگر پشتیبانی نمی‌شود، و روش activities.list دیگر بولتن‌های کانال را برنمی‌گرداند. برای جزئیات بیشتر، لطفاً مرکز راهنمایی YouTube را ببینید.

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

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

YouTube ویژگی اعلامیه کانال را منسوخ می‌کند. درنتیجه، روش activities.insert منسوخ خواهد شد و روش activities.list دیگر بولتن‌های کانال را برنمی‌گرداند. این تغییرات در API در تاریخ ۱۸ مه ۲۰۲۰ یا پس‌از آن اعمال خواهد شد. برای جزئیات بیشتر، لطفاً مرکز راهنمایی YouTube را ببینید.

‫۳۱ مارس ۲۰۲۰

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

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

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

      این منبع جایگزین منبع sponsor می‌شود که به‌عنوان بخشی از YouTube Live Streaming API مستند شده است. منبع sponsor اکنون منسوخ شده است و کارخواه‌های API باید تماس‌ها با روش sponsors.list را به‌روز کنند تا به‌جای آن از روش members.list استفاده کنند.

    • منبع جدید membershipsLevel سطح قیمت‌گذاری مدیریت‌شده توسط محتواساز را که درخواست API را مجاز کرده است شناسایی می‌کند. روش membershipsLevels.list فهرستی از همه سطوح عضویت محتواساز را بازیابی می‌کند.

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

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

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

  • ویژگی selfDeclaredMadeForKids به محتواسازان امکان می‌دهد مشخص کنند که آیا کانال یا ویدیو برای کودکان ساخته شده است یا نه.

    برای کانال‌ها، این ویژگی را می‌توان هنگام فراخوانی روش channels.update تنظیم کرد. برای ویدیوها، این ویژگی را می‌توان هنگام فراخوانی روش‌های videos.insert یا videos.update تنظیم کرد.

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

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

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

سند مرجع API به‌روزرسانی شده است تا تغییری را در نحوه گزارش تعداد مشترکین در YouTube و درنتیجه در پاسخ‌های API نشان دهد. درنتیجه این تغییر، تعداد مشترکان برگردانده‌شده توسط سرویس YouTube Data API برای تعداد مشترکان بیشتر از ۱۰۰۰ مشترک، به سه رقم بااهمیت گرد می‌شود. این تغییر بر ویژگی statistics.subscriberCount منبع channel تأثیر می‌گذارد.

توجه: این تغییر بر مقدار این ویژگی تأثیر می‌گذارد، حتی در مواردی که کاربر درخواست مجاز برای داده‌های مربوط به کانال خود ارسال می‌کند. مالکان کانال همچنان می‌توانند تعداد دقیق مشترکان را در «استودیوِ YouTube» ببینند.

برای مثال، اگر کانالی ۱۲۳٬۴۵۶ مشترک داشته باشد، ویژگی statistics.subscriberCount حاوی مقدار 123000 خواهد بود. جدول زیر نمونه‌هایی از نحوه گرد کردن تعداد مشترکان در پاسخ‌های API و خلاصه کردن آن‌ها در سایر میاناهای کاربر YouTube که به‌صورت عمومی قابل‌مشاهده هستند را نشان می‌دهد:

نمونه تعداد مشترکان YouTube Data API رابط‌های کاربری YouTube که به‌طور عمومی قابل‌مشاهده هستند
‫۱٬۲۳۴ 1230 ‫۱٫۲۳هزار
‫12,345 12300 ‫۱۲٫۳ هزار
‫۱۲۳٬۴۵۶ 123000 ‫۱۲۳ هزار
1,234,567 1230000 ‫۱٫۲۳ میلیون
‫۱۲٬۳۴۵٬۶۷۸ 12300000 ‫۱۲٫۳ میلیون
‫۱۲۳٬۴۵۶٬۷۸۹ 123000000 ‫۱۲۳ میلیون

۴ آوریل ۲۰۱۹

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

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

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

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

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

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

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

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

  • راهنماهای شروع سریع برای Java،‏ JavaScript،‏ PHP، و Python به‌روز شده‌اند. راهنماهای بازبینی‌شده توضیح می‌دهند که چگونه می‌توان یک نمونه را با کلید میانای برنامه‌سازی کاربردی و نمونه دیگر را با شناسه کارخواه OAuth 2.0 بااستفاده از نمونه کدهای APIs Explorer اجرا کرد.

توجه داشته باشید که تغییرات شرح‌داده‌شده در بالا جایگزین ابزار تعاملی‌ای می‌شود که در سال ۲۰۱۷ به اسناد API اضافه شده بود.

۹ ژوئیه ۲۰۱۸

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

  • تعریف ویژگی snippet.thumbnails منبع channel به‌روزرسانی شده است تا توجه داشته باشید که هنگام نمایش تصاویر کوچک در برنامه، کد شما باید از نشانی‌های وب تصویر دقیقاً همان‌طور که در پاسخ‌های API برگردانده می‌شوند استفاده کند. برای مثال، برنامه شما نباید از دامنه http به‌جای دامنه https در نشانی وب برگردانده‌شده در پاسخ میانای برنامه‌سازی کاربردی استفاده کند.

    از ژوئیه ۲۰۱۸، نشانی‌های وب ریزعکس کانال فقط در دامنه https دردسترس خواهند بود، که نحوه نمایش نشانی‌های وب در پاسخ‌های میانای برنامه‌سازی کاربردی است. پس‌از آن زمان، اگر برنامه‌تان سعی کند تصاویر YouTube را از دامنه http بار کند، ممکن است تصاویر خراب در برنامه‌تان ببینید.

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

    خصوصیت recordingDetails.location.altitude منبع video منسوخ شده است. هیچ تضمینی وجود ندارد که ویدیوها مقادیری را برای این ویژگی برگردانند. به‌طور مشابه، حتی اگر درخواست‌های میانای برنامه‌سازی کاربردی تلاش کنند مقداری برای آن ویژگی تنظیم کنند، ممکن است داده‌های ورودی ذخیره نشوند.

۲۲ ژوئن ۲۰۱۸

راهنمای پیاده‌سازی، که قبلاً با نام «راهنمای پیاده‌سازی و انتقال» شناخته می‌شد، به‌روزرسانی شده است تا دستورالعمل‌های انتقال از میانای برنامه‌سازی کاربردی نسخه ۲ به میانای برنامه‌سازی کاربردی نسخه ۳ برداشته شود. علاوه‌براین، دستورالعمل‌های مربوط به ویژگی‌هایی که از زمان معرفی v3 API منسوخ شده‌اند، مانند ویدیوهای دلخواه، نیز حذف شده‌اند.

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

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

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

    ‫YouTube پشتیبانی از ویژگی‌های ویدیو ویژه و وب‌سایت ویژه را که در API ازطریق شیء invideoPromotion منبع channel پشتیبانی می‌شوند، حذف می‌کند. درنتیجه، آن شیء، ازجمله همه ویژگی‌های فرزند آن، درحال منسوخ شدن است.

    تا ۱۴ دسامبر ۲۰۱۷ همچنان می‌توانید داده‌های invideoPromotion را بازیابی و تنظیم کنید. بعداز آن تاریخ:

    • تلاش برای بازیابی بخش invideoPromotion هنگام فراخوانی channels.list، invideoPromotion خالی برمی‌گرداند یا اصلاً هیچ داده invideoPromotion برنمی‌گرداند.
    • تلاش برای به‌روزرسانی داده‌های invideoPromotion هنگام تماس با channels.update حداقل تا ۲۷ مه ۲۰۱۸ پاسخ موفقیت‌آمیز برمی‌گرداند، اما این تلاش‌ها به‌عنوان عملیات بی‌تأثیر درنظر گرفته می‌شوند، یعنی درواقع به‌روزرسانی انجام نمی‌دهند.

    پس‌از ۲۷ مه ۲۰۱۸، ممکن است این درخواست‌ها پیام‌های خطایی را برگردانند که نشان می‌دهد، برای مثال، invalidPromotion بخش نامعتبری است.

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

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

  • ابزار تعاملی تکه‌کد اکنون از نمونه‌های کد Node.js پشتیبانی می‌کند. نمونه‌ها همچنین در اسناد مربوط به تقریباً همه روش‌های API، مانند روش channels.list، قابل‌مشاهده هستند.

    نمونه‌های قابل‌سفارشی‌سازی به‌گونه‌ای طراحی شده‌اند که نقطه شروعی مختص مورد استفاده برای برنامه Node.js دراختیارتان قرار دهند. عملکرد آن مشابه کد موجود در راهنمای شروع سریع Node.js است. بااین‌حال، نمونه‌ها حاوی برخی توابع سودمندی هستند که در شروع سریع نشان داده نمی‌شوند:

    • تابع removeEmptyParameters فهرستی از جفت‌های کلید-مقدار مربوط به پارامترهای درخواست API را می‌گیرد و پارامترهایی را که مقدار ندارند حذف می‌کند.
    • تابع createResource فهرستی از جفت‌های کلید-مقدار را که با ویژگی‌های منبع میانای برنامه‌سازی کاربردی مطابقت دارد می‌گیرد. سپس ویژگی‌ها را به شیء JSON تبدیل می‌کند که می‌تواند در عملیات insert و update استفاده شود. مثال زیر مجموعه‌ای از نام‌ها و مقادیر دارایی و شیء JSON را نشان می‌دهد که کد برای آن‌ها ایجاد می‌کند: 
      # Key-value pairs:
{'id': 'ABC123',
 'snippet.title': 'Resource title',
 'snippet.description': 'Resource description',
 'status.privacyStatus': 'private'}

# JSON object:
{
 'id': 'ABC123',
 'snippet': {
   'title': 'Resource title',
   'description': 'Resource description',
 },
 'status': {
   'privacyStatus': 'private'
 }
}

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

۲۵ اکتبر ۲۰۱۷

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

  • نمونه‌های کد Python در ابزار تعاملی تکه‌کد به‌روزرسانی شده‌اند تا به‌جای کتابخانه oauth2client که اکنون منسوخ شده است، از کتابخانه‌های google-auth و google-auth-oauthlib استفاده کنند.

    علاوه‌بر این تغییر، این ابزار اکنون نمونه‌های کد کامل برای برنامه‌های Python نصب‌شده و برنامه‌های سرور وب Python ارائه می‌دهد که از جریان‌های مجوزدهی کمی متفاوت استفاده می‌کنند. برای دیدن نمونه‌های کامل (و این تغییر):

    1. به ابزار تعاملی تکه‌کد یا به اسناد مربوط به هر روش API، مانند روش channels.list، بروید.
    2. روی برگه Python در بالای نمونه‌های کد کلیک کنید.
    3. روی کلید بالای برگه‌ها کلیک کنید تا از دیدن قطعه به نمونه کامل بروید.
    4. اکنون برگه باید نمونه کد کاملی را نشان دهد که از جریان مجوز InstalledAppFlow استفاده می‌کند. توضیحات بالای نمونه این موضوع را توضیح می‌دهد و همچنین به نمونه‌ای برای برنامه سرور وب پیوند می‌دهد.
    5. برای رفتن به نمونه سرور وب، روی پیوند کلیک کنید. آن نمونه از چارچوب برنامه وب Flask و جریان صدور مجوز متفاوتی استفاده می‌کند.

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

‫۲۹ اوت ۲۰۱۷

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

  • تعریف پارامتر forContentOwner روش search.list به‌روز شده است تا مشخص شود که اگر آن پارامتر روی true تنظیم شده باشد، پارامتر type باید روی video تنظیم شود.
  • تعریف پارامتر regionCode روش search.list به‌روزرسانی شده است تا مشخص شود که این پارامتر نتایج جستجو را به ویدیوهایی محدود می‌کند که در منطقه مشخص‌شده قابل‌مشاهده هستند.
  • YouTube نشان‌واره‌ها و نمادهای نمانام‌سازی خود را به‌روز کرده است. لوگوهای جدید «توسعه‌یافته با YouTube» را می‌توانید از صفحه رهنمودهای نمانام‌سازی بارگیری کنید. سایر نشان‌واره‌ها و نمادهای جدید YouTube نیز در آن صفحه نشان داده شده‌اند و می‌توان آن‌ها را از سایت نمانام YouTube بارگیری کرد.

۲۴ ژوئیه ۲۰۱۷

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

  • راهنمای شروع سریع YouTube Data API جدیدی برای iOS دردسترس است. این راهنما نحوه استفاده از YouTube Data API را در یک برنامه ساده iOS که به زبان Objective-C یا Swift نوشته شده است توضیح می‌دهد.
  • ابزار تعاملی قطعه کد برای YouTube Data API اکنون شامل اسنادی است که برخی از ویژگی‌های ابزار را توضیح می‌دهد:
    • درحال اجرای درخواست‌های میانای برنامه‌سازی کاربردی
    • جابه‌جایی بین تکه‌کدها و نمونه‌های کد کامل
    • استفاده از توابع تکراری
    • درحال بار کردن منابع موجود (برای روش‌های به‌روزرسانی)

    توجه: این ابزار همچنین در اسناد مرجع میانای برنامه‌سازی کاربردی برای روش‌های میانای برنامه‌سازی کاربردی (نمونه) جاسازی شده است.

۱ ژوئن ۲۰۱۷

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

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

    مشخصه‌های منبع video زیر درحال منسوخ شدن است. درحالی‌که این ویژگی‌ها تا ۱ دسامبر ۲۰۱۷ پشتیبانی خواهند شد، هیچ تضمینی وجود ندارد که ویدیوها تا آن زمان به برگرداندن مقادیر برای آن ویژگی‌ها ادامه دهند. به‌طور مشابه، درخواست‌های videos.insert و videos.update که آن مقادیر دارایی را تنظیم می‌کنند، قبل‌از آن تاریخ خطا ایجاد نخواهند کرد، اما ممکن است داده‌های ورودی ذخیره نشوند.

‫۱۷ مه ۲۰۱۷

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

  • سند مرجع میانای برنامه‌سازی کاربردی به‌روز شده است تا تکه‌کدها فراگیرتر و تعاملی‌تر شوند. صفحاتی که روش‌های API را توضیح می‌دهند، مانند channels.list یا videos.rate، اکنون دارای یک ابزار تعاملی هستند که به شما امکان می‌دهد قطعه کدهای Java، JavaScript، PHP، Python، Ruby، Apps Script و Go را مشاهده و سفارشی‌سازی کنید.

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

    همچنین می‌توانید با نمونه‌های کد تعامل داشته باشید:

    • مقادیر پارامتر و ویژگی را تغییر دهید و تکه‌کدها به‌طور پویا به‌روز می‌شوند تا مقادیری را که ارائه می‌دهید منعکس کنند.

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

    • با کلیک کردن روی دکمه، درخواست‌ها را اجرا کنید. (برای اجرای درخواست‌ها، باید به ابزار اجازه دهید تا ازطرف شما با میانای برنامه‌سازی کاربردی تماس بگیرد.)

    توجه داشته باشید که این ابزار جایگزین API Explorer در صفحاتی شده است که دردسترس است. (هر صفحه پیوندی را نمایش می‌دهد تا این گزینه را نیز داشته باشید که درخواستی را که روی آن کار می‌کنید در API Explorer بار کنید.)

  • ابزار تکه‌کدهای Data API نیز با واسط کاربر جدیدی به‌روز شده است که همه ویژگی‌های شرح‌داده‌شده در بالا را ارائه می‌دهد. ویژگی‌های جدید اصلی دردسترس در این صفحه عبارت‌اند از:

    • پشتیبانی از درخواست‌های API که داده‌ها را می‌نویسند.
    • پشتیبانی از نمونه‌های جاوا.
    • کد متن استاندارد جامع‌تر و انعطاف‌پذیرتر برای صدور مجوز برای کاربران و ساخت درخواست‌های API.

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

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

  • راهنماهای شروع سریع جدید توضیح می‌دهند که چگونه یک برنامه ساده راه‌اندازی کنید که درخواست‌های YouTube Data API را انجام می‌دهد. درحال‌حاضر راهنماها برای Android،‏ Apps Script،‏ Go،‏ Java،‏ JavaScript،‏ Node.js،‏ PHP،‏ Python، و Ruby دردسترس هستند.

‫۳۰ مارس ۲۰۱۷

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

  • ویژگی جدید topicDetails.topicCategories[] منبع channel حاوی فهرستی از نشانی‌های وب ویکی‌پدیا است که محتوای کانال را توصیف می‌کنند. نشانی‌های وب با شناسه‌های موضوع برگردانده‌شده در ویژگی topicDetails.topicIds[] منبع مطابقت دارند.
  • ویژگی جدید contentDetails.videoPublishedAt منبع playlistItem زمانی را که ویدیو در YouTube منتشر شده است شناسایی می‌کند. منبع ازقبل حاوی ویژگی snippet.publishedAt است که زمان اضافه شدن مورد به فهرست پخش را مشخص می‌کند.
  • مانند منبع channel، منبع video اکنون ویژگی topicDetails.topicCategories[] را برمی‌گرداند که شامل فهرستی از نشانی‌های وب ویکی‌پدیا است که محتوای ویدیو را توصیف می‌کنند. برای منابع video، نشانی‌های وب با شناسه‌های موضوعی که در ویژگی topicDetails.relevantTopicIds[] منبع برگردانده شده‌اند مطابقت دارند.
  • ویژگی جدید contentDetails.contentRating.mpaatRating منبع video رده‌بندی‌ای را که «انجمن تصاویر متحرک امریکا» به پیش‌پرده یا پیش‌نمایش فیلم داده است شناسایی می‌کند.

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

همان‌طور که در ابتدا در ۱۱ اوت ۲۰۱۶ اعلام شد، YouTube فهرست شناسه موضوعات پشتیبانی‌شده را به فهرست گزینش‌شده تغییر داده است. فهرست کامل شناسه‌های موضوع پشتیبانی‌شده در ویژگی‌های topicDetails برای منابع channel و video و همچنین در پارامتر topicId روش search.list گنجانده شده است.

توجه داشته باشید که چندین تغییر در فهرست گلچین‌شده وجود دارد:

  • موضوعات زیر به‌عنوان زیرموضوع Society اضافه شده‌اند:
    نامشناسه موضوع
    کسب‌وکار/m/09s1f
    سلامت/m/0kt51
    نظامی/m/01h6rj
    سیاست/m/05qt0
    مذهب/m/06bvp
  • موضوع Animated cartoon که قبلاً زیرمجموعه Entertainment بود برداشته شده است.
  • موضوع Children's music که قبلاً زیرمجموعه Music بود برداشته شده است.

درنتیجه این تغییر، موضوعات مرتبط با ویدیو اکنون همیشه در مقدار ویژگی topicDetails.relevantTopicIds[] منبع video برگردانده می‌شوند.

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

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

  • سه تغییر کوچک در فهرست شناسه‌های موضوعی که از ۱۰ فوریه ۲۰۱۷ پشتیبانی خواهند شد وجود دارد:

    • دسته Professional wrestling که قبلاً زیرمجموعه دسته Sports بود، اکنون زیرمجموعه Entertainment است.
    • دسته TV shows که زیرمجموعه Entertainment است جدید است.
    • دسته Health که قبلاً زیرمجموعه Lifestyle بود برداشته شده است.

    همچنین توجه داشته باشید که چند دسته اصلی وجود دارد (Entertainment، Gaming، Lifestyle، Music، و Sports). هر ویدیویی که با یک دسته فرعی مرتبط باشد، مانند Tennis، با دسته اصلی (Sports) نیز مرتبط خواهد بود.

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

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

  • همان‌طور که اولین‌بار در ۱۱ اوت ۲۰۱۶ اعلام شد، منسوخ شدن Freebase و Freebase API مستلزم چندین تغییر مربوط به شناسه‌های موضوع است. شناسه‌های موضوع، موضوعات مرتبط با منابع channel و video را شناسایی می‌کنند و همچنین می‌توانید از پارامتر جستجوی topicId برای پیدا کردن کانال‌ها یا ویدیوهای مرتبط با موضوعی خاص استفاده کنید.

    در ۱۰ فوریه ۲۰۱۷، YouTube شروع به برگرداندن مجموعه کوچکی از شناسه‌های موضوع به‌جای مجموعه شناسه‌های بسیار دقیق‌تری که تاکنون برگردانده می‌شد، خواهد کرد. علاوه‌براین، توجه داشته باشید که تضمینی وجود ندارد که کانال‌ها و ویدیوها با موضوعی مرتبط باشند، که این امر با رفتار فعلی میانای برنامه‌سازی کاربردی مطابقت دارد.

    برای اینکه بتوانید «کارخواه‌های API» خود را برای این تغییرات آماده کنید، تعاریف پارامترها و ویژگی‌های API زیر به‌روز شده‌اند تا شناسه‌های موضوعی را که پس‌از آن زمان پشتیبانی خواهند شد فهرست کنند. توجه داشته باشید که فهرست دسته‌ها برای همه دارایی‌ها یکسان است.

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

    مشخصه‌های زیر درحال منسوخ شدن هستند:

    • خصوصیت topicDetails.topicIds[] منبع channel. این ویژگی تا ۱۰ نوامبر ۲۰۱۷ پشتیبانی خواهد شد.
    • خصوصیت topicDetails.relevantTopicIds[] منبع video. این ویژگی تا ۱۰ نوامبر ۲۰۱۷ پشتیبانی خواهد شد.
    • خصوصیت topicDetails.topicIds[] منبع video. این ویژگی پس‌از ۱۰ فوریه ۲۰۱۷ حاوی مقادیر نخواهد بود. (پس‌از آن تاریخ، مقدار ویژگی topicDetails.relevantTopicIds[] همه موضوعات مرتبط با ویدیو را شناسایی خواهد کرد.)

  • ازآنجایی‌که Freebase قبلاً منسوخ شده است، راهنمای جستجو با موضوعات Freebase از اسناد حذف شده است. آن راهنما نمونه کدهایی ارائه می‌داد تا نشان دهد چگونه یک برنامه با Freebase API کار می‌کند.

    علاوه‌براین، چندین نمونه کد مربوط به شناسه‌های موضوع از اسناد روش search.list برداشته شده است.

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

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

  • ویژگی‌ها و پارامترهای جدید

    • منبع video حاوی چندین ویژگی جدید است:

      • ویژگی player.embedHtml حاوی برچسب <iframe> است که می‌توانید از آن برای جاسازی پخش‌کننده‌ای که ویدیو را پخش می‌کند استفاده کنید. ویژگی‌های جدید player.embedHeight و player.embedWidth ابعاد پخش‌کننده جاسازی‌شده را مشخص می‌کنند. این ویژگی‌ها فقط درصورتی برگردانده می‌شوند که درخواست API مقداری را برای حداقل یکی از پارامترهای maxHeight یا maxWidth مشخص کند. این دو پارامتر جدید در ادامه این ورودی سابقه ویرایش توضیح داده شده‌اند.

      • ویژگی جدید hasCustomThumbnail نشان می‌دهد که آیا بارگذارنده ویدیو تصویر ریزعکس سفارشی برای ویدیو ارائه کرده است یا نه. توجه داشته باشید که این ویژگی فقط برای بارگذارنده ویدیو قابل‌مشاهده است.

      • fpbRatingReasons[] جدید دلایلی را که ویدیو رده‌بندی FPB (آفریقای جنوبی) را دریافت کرده است مشخص می‌کند.

      • mcstRating جدید رده‌بندی‌ای را که ویدیو در ویتنام دریافت کرده است مشخص می‌کند.

    • روش videos.list از دو پارامتر جدید maxHeight و maxWidth پشتیبانی می‌کند. می‌توانید از هرکدام از پارامترها یا هر دو پارامتر هنگام بازیابی بخش player در منابع video استفاده کنید.

      به‌طور پیش‌فرض، ارتفاع <iframe> برگردانده‌شده در ویژگی player.embedHtml برابر با ۳۶۰ پیکسل است. عرض با نسبت ابعادی ویدیو مطابقت دارد، بنابراین تضمین می‌کند که پخش‌کننده جاسازی‌شده نوارهای سیاه در اطراف ویدیو نداشته باشد. بنابراین، برای مثال، اگر نسبت ابعادی ویدیو ۱۶:۹ باشد، عرض پخش‌کننده ۶۴۰ پیکسل خواهد بود.

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

      برای مثال، فرض کنید ویدیویی دارای نسبت ابعادی ۱۶:۹ است. بنابراین، اگر پارامتر maxHeight یا maxWidth تنظیم نشده باشد، برچسب player.embedHtml حاوی پخش‌کننده ۶۴۰x۳۶۰ خواهد بود.

      • اگر پارامتر maxHeight روی 720 تنظیم شده باشد و پارامتر maxWidth تنظیم نشده باشد، API یک پخش‌کننده ۱۲۸۰x۷۲۰ برمی‌گرداند.
      • اگر پارامتر maxWidth روی 960 تنظیم شده باشد و پارامتر maxHeight تنظیم نشده باشد، API یک پخش‌کننده با ابعاد ۹۶۰x۵۴۰ برمی‌گرداند.
      • اگر پارامتر maxWidth روی 960 تنظیم شده باشد و پارامتر maxHeight روی 450 تنظیم شده باشد، API پخش‌کننده ۸۰۰×۴۵۰ را برمی‌گرداند.

      مشخصه‌های جدید player.embedHeight و player.embedWidth که در بالا شرح داده شده‌اند، ابعاد پخش‌کننده را مشخص می‌کنند.

  • به‌روزرسانی روش‌ها، ویژگی‌ها، و پارامترهای موجود

    • شرح منبع channelSection به‌روزرسانی شده است تا مشخص شود که کانال می‌تواند حداکثر ۱۰ قفسه بدون تنظیم داده‌های هدف‌یابی ایجاد کند و می‌تواند حداکثر ۱۰۰ قفسه با داده‌های هدف‌یابی ایجاد کند.

      علاوه‌براین، ویژگی targeting منبع channelSection به‌روزرسانی شده است تا نشان دهد که گزینه‌های هدف‌یابی فقط بااستفاده از میانای برنامه‌سازی کاربردی قابل تنظیم است. اگر بخش کانال بااستفاده از میانای کاربر در وب‌سایت YouTube اصلاح شود، گزینه‌های هدف‌یابی حذف می‌شوند.

    • تعریف ویژگی snippet.name منبع i18nLanguage اصلاح شده است تا نشان دهد که این مقدار نشان‌دهنده نام زبان است، همان‌طور که در زبان مشخص‌شده توسط پارامتر hl روش i18nLanguage.list نوشته شده است.

    • ویژگی contentDetails.note منبع playlistItem به‌روزرسانی شده است تا نشان دهد حداکثر طول مقدار ویژگی ۲۸۰ نویسه است.

    • خصوصیات contentDetails.startAt و contentDetails.endAt منبع playlistItem منسوخ شده‌اند. اگر این فیلدها در درخواست‌های playlistItems.insert یا playlistItems.update تنظیم شده باشند، نادیده گرفته می‌شوند.

    • روش‌های playlistItems.delete و playlistItems.update اکنون از پارامتر onBehalfOfContentOwner پشتیبانی می‌کنند که قبلاً برای چندین روش دیگر پشتیبانی می‌شد. درخواست‌هایی که از این روش استفاده می‌کنند باید با یک توکن که دسترسی به دامنه https://www.googleapis.com/auth/youtubepartner را فراهم می‌کند، مجاز شوند.

    • پارامترهای publishedBefore و publishedAfter روش search.list هر دو به‌روز شده‌اند تا نشان دهند که مقادیر پارامتر شامل هستند. بنابراین، برای مثال، اگر پارامتر publishedBefore تنظیم شده باشد، API منابع ایجادشده قبل‌از یا در زمان مشخص‌شده را برمی‌گرداند.

    • ویژگی contentDetails.contentRating.grfilmRating منبع video از سه مقدار دیگر پشتیبانی می‌کند: grfilmK12، grfilmK15، و grfilmK18.

    • شرح روش videos.insert به‌روزرسانی شده است تا نشان دهد حداکثر اندازه فایل برای ویدیوهای بارگذاری‌شده از ۶۴ گیگابایت به ۱۲۸ گیگابایت افزایش یافته است.

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

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

      نوع خطا جزئیات خطا شرح
      forbidden (403) homeParameterDeprecated روش activities.list این خطا را برمی‌گرداند تا نشان دهد داده‌های فعالیت صفحه اصلی کاربر ازطریق این API دردسترس نیست. اگر پارامتر home را در درخواست غیرمجاز روی true تنظیم کنید، ممکن است این خطا رخ دهد.
      invalidValue (400) invalidContentDetails روش playlistItems.insert این خطا را برمی‌گرداند تا نشان دهد شیء contentDetails در درخواست نامعتبر است. یکی از دلایل بروز این خطا این است که فیلد contentDetails.note طولانی‌تر از ۲۸۰ نویسه است.
      forbidden (403) watchHistoryNotAccessible روش playlistItems.list این خطا را برمی‌گرداند تا نشان دهد که درخواست تلاش کرده است موارد فهرست پخش «سابقه تماشا» را بازیابی کند، اما این موارد بااستفاده از API قابل بازیابی نیستند.
      forbidden (403) watchLaterNotAccessible روش playlistItems.list این خطا را برمی‌گرداند تا نشان دهد که درخواست تلاش کرده است موارد فهرست پخش «تماشا در فرصتی دیگر» را بازیابی کند، اما این موارد بااستفاده از API قابل بازیابی نیستند.
      badRequest (400) uploadLimitExceeded روش videos.insert این خطا را برمی‌گرداند تا نشان دهد که کانال از تعداد ویدیوهایی که می‌تواند بارگذاری کند فراتر رفته است.
      forbidden (403) forbiddenEmbedSetting روش videos.update این خطا را برمی‌گرداند تا نشان دهد که درخواست میانای برنامه‌سازی کاربردی تلاش می‌کند تنظیم جاسازی نامعتبری برای ویدیو تنظیم کند. توجه داشته باشید که ممکن است برخی کانال‌ها اجازه ارائه پخش‌کننده‌های جاسازی‌شده برای جاری‌سازی‌های زنده را نداشته باشند. برای اطلاعات بیشتر، به مرکز راهنمایی YouTube مراجعه کنید.

    • اگر ویدیو تکراری را در فهرست پخش درج کنید، روش playlistItems.insert دیگر خطایی برنمی‌گرداند. این خطا قبلاً برای برخی فهرست‌های پخش، مانند ویدیوهای موردعلاقه، رخ می‌داد که تکرار را مجاز نمی‌دانستند اما دیگر پشتیبانی نمی‌شوند. به‌طور کلی، فهرست‌های پخش اجازه ویدیوهای تکراری را می‌دهند.

  • سایر به‌روزرسانی‌ها

    • ورودی سابقه ویرایش برای ۱۵ سپتامبر ۲۰۱۶ به‌روزرسانی شده است تا روشن شود که هرگاه ویژگی‌های contentDetails.relatedPlaylists.watchHistory و contentDetails.relatedPlaylists.watchLater منبع channel در پاسخی گنجانده شوند، همیشه به‌ترتیب حاوی مقادیر HL و WL هستند. علاوه‌براین، این ویژگی‌ها فقط درصورتی گنجانده می‌شوند که یک کاربر مجاز درحال بازیابی داده‌های مربوط به کانال خود کاربر باشد.

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

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

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

  • تغییرات زیر اکنون اعمال شده‌اند. اعلان این تغییرات در به‌روزرسانی سابقه ویرایش در ۱۱ اوت ۲۰۱۶ ارائه شد:

    • اگر روش activities.list با پارامتر home تنظیم‌شده روی true فراخوانی شود، پاسخ میانای برنامه‌سازی کاربردی اکنون حاوی مواردی مشابه آنچه است که کاربر خارج‌شده از سیستم YouTube در صفحه اصلی می‌بیند.

      این تغییر جزئی با هدف ارائه تجربه کاربری بهتر نسبت‌به رفتار شرح‌داده‌شده در به‌روزرسانی سابقه ویرایش در ۱۱ اوت ۲۰۱۶ انجام شده است. در آن به‌روزرسانی اعلام شده بود که درخواست‌هایی که از پارامتر home استفاده می‌کنند فهرست خالی برمی‌گردانند.

    • ویژگی‌های contentDetails.relatedPlaylists.watchHistory و contentDetails.relatedPlaylists.watchLater منبع channel اکنون به‌ترتیب حاوی مقادیر HL و WL برای همه کانال‌ها هستند.

      برای شفاف‌سازی، این ویژگی‌ها فقط برای کاربر مجاز که داده‌های مربوط به کانال خود کاربر را بازیابی می‌کند قابل‌مشاهده است. این ویژگی‌ها همیشه حاوی مقادیر HL و WL هستند، حتی برای کاربر مجاز که داده‌های مربوط به کانال خود کاربر را بازیابی می‌کند. بنابراین، شناسه‌های فهرست پخش «تماشا در فرصتی دیگر» و سابقه تماشا را نمی‌توان ازطریق API بازیابی کرد.

      علاوه‌براین، درخواست‌های بازیابی جزئیات فهرست پخش (playlists.list) یا موارد فهرست پخش (playlistItems.list) برای سابقه تماشای کانال یا فهرست پخش «تماشا در فرصتی دیگر» اکنون فهرست‌های خالی برمی‌گردانند. این رفتار برای مقادیر جدید، HL و WL، و همچنین برای هر شناسه فهرست پخش سابقه تماشا یا تماشا در فرصتی دیگر که ممکن است «کارخواه میانای برنامه‌سازی کاربردی» شما قبلاً ذخیره کرده باشد، صادق است.

  • شیء fileDetails.recordingLocation منبع video و ویژگی‌های فرزند آن دیگر برگردانده نمی‌شوند. قبلاً این داده‌ها (مانند شیء والد fileDetails) فقط توسط مالک ویدیو قابل بازیابی بود.

۱۱ اوت ۲۰۱۶

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

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

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

  • منسوخ شدن Freebase و Freebase API باعث ایجاد چندین تغییر مرتبط با شناسه‌های موضوع می‌شود. شناسه‌های موضوع در منابع و روش‌های API زیر استفاده می‌شوند:

    • بخش topicDetails منبع channel موضوعات مرتبط با کانال را شناسایی می‌کند.
    • بخش topicDetails منبع video موضوعات مرتبط با ویدیو را شناسایی می‌کند.
    • پارامتر topicId روش search.list به شما امکان می‌دهد ویدیوها یا کانال‌های مرتبط با موضوعی خاص را جستجو کنید.

    تغییرات این ویژگی‌ها عبارت‌اند از:

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

    • هر شناسه موضوع Freebase که قبلاً بازیابی کرده‌اید می‌تواند تا ۱۰ فوریه ۲۰۱۷ برای جستجوی محتوا استفاده شود. بااین‌حال، پس‌از آن زمان، فقط می‌توانید از مجموعه کوچک‌تر موضوعات شناسایی‌شده در مورد قبلی برای بازیابی نتایج جستجو براساس موضوع استفاده کنید.

    • پس‌از ۱۰ فوریه ۲۰۱۷، اگر بخواهید بااستفاده از شناسه موضوعی که در مجموعه کوچک‌تر شناسه‌های موضوع پشتیبانی‌شده نیست نتایج را جستجو کنید، API مجموعه نتایج خالی برمی‌گرداند.

  • چندین فیلد و پارامتر API از ۱۲ سپتامبر ۲۰۱۶ منسوخ می‌شوند:

    • پارامتر home روش activities.list به کاربر مجاز امکان می‌داد فید فعالیت را که در صفحه اصلی YouTube برای آن کاربر نمایش داده می‌شد بازیابی کند. درخواست‌هایی که پس‌از ۱۲ سپتامبر ۲۰۱۶ از این پارامتر استفاده کنند، فهرست خالی برمی‌گردانند.

    • ویژگی‌های contentDetails.relatedPlaylists.watchHistory و contentDetails.relatedPlaylists.watchLater منبع channel فقط برای کاربر مجاز که داده‌های مربوط به کانال خود کاربر را بازیابی می‌کند قابل‌مشاهده است. پس‌از ۱۲ سپتامبر ۲۰۱۶، contentDetails.relatedPlaylists.watchHistory مقدار HL را برمی‌گرداند و ویژگی contentDetails.relatedPlaylists.watchLater مقدار WL را برای همه کانال‌ها برمی‌گرداند.

      درخواست‌های بازیابی جزئیات فهرست پخش (playlists.list) برای سابقه تماشا یا فهرست پخش تماشا در فرصتی دیگر یک کانال، پس‌از ۱۲ سپتامبر ۲۰۱۶ فهرست خالی برمی‌گرداند. درخواست‌های بازیابی موارد فهرست پخش (playlistItems.list) در هریک از این فهرست‌های پخش نیز پس‌از آن زمان، فهرست خالی برمی‌گرداند. این موضوع برای مقادیر جدید، HL و WL، و همچنین برای هر شناسه فهرست پخش سابقه تماشا یا تماشا در فرصتی دیگر که «کارخواه میانای برنامه‌سازی کاربردی» شما ممکن است قبلاً ذخیره کرده باشد، صادق است.

    • شیء fileDetails.recordingLocation منبع video یا هرکدام از ویژگی‌های فرزند آن پس‌از ۱۲ سپتامبر ۲۰۱۶ دیگر برگردانده نخواهد شد. این داده‌ها فقط توسط مالک ویدیو قابل بازیابی است زیرا شیء اصلی fileDetails فقط توسط مالک ویدیو قابل بازیابی است.

‫۱۳ ژوئن ۲۰۱۶

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

  • خصوصیت contentDetails.googlePlusUserId منبع channel منسوخ شده است. قبلاً، این ویژگی فقط درصورتی وجود داشت که کانال با نمایه Google+‎ مرتبط بود. پس‌از منسوخ شدن، این ویژگی دیگر در هیچ‌یک از منابع channel گنجانده نخواهد شد.

  • خصوصیت snippet.authorGoogleplusProfileUrl منبع comment منسوخ شده است. قبلاً، این ویژگی فقط درصورتی وجود داشت که کانال با نمایه Google+‎ مرتبط بود. پس‌از منسوخ شدن، این ویژگی دیگر در هیچ‌یک از منابع comment گنجانده نخواهد شد.

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

‫۳۱ مه ۲۰۱۶

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

  • پارامتر جدید myRecentSubscribers در روش subscriptions.list فهرستی از مشترکین کانال کاربر اصالت‌سنجی‌شده را به‌ترتیب زمانی معکوس از زمان اشتراک آن‌ها در کانال بازیابی می‌کند.

    توجه داشته باشید که پارامتر جدید فقط از بازیابی ۱۰۰۰ مشترک اخیر کانال کاربر اصالت‌سنجی‌شده پشتیبانی می‌کند. برای بازیابی فهرست کامل مشترکین، از پارامتر mySubscribers استفاده کنید. این پارامتر که مشترکین را با ترتیب خاصی برنمی‌گرداند، تعداد مشترکینی را که می‌توان بازیابی کرد محدود نمی‌کند.

  • تعریف ویژگی snippet.thumbnails.(key) برای منابع فعالیت، playlistItem، فهرست پخش، نتیجه جستجو، تصویر کوچک، و ویدیو به‌روزرسانی شده است تا نشان دهد که اندازه‌های تصویر کوچک اضافی برای برخی ویدیوها دردسترس است.

    • تصویر standard دارای عرض ۶۴۰ پیکسل و ارتفاع ۴۸۰ پیکسل است.
    • تصویر maxres دارای عرض ۱۲۸۰ پیکسل و ارتفاع ۷۲۰ پیکسل است.

  • تعریف پارامتر part روش channelSection.list به‌روزرسانی شده است تا توجه شود که بخش targeting را می‌توان با هزینه 2 واحد سهمیه بازیابی کرد.

  • اکنون وقتی درخواستی که به‌درستی مجوز ندارد تلاش می‌کند بخش‌های fileDetails، processingDetails، یا suggestions منبع video را بازیابی کند، روش videos.list خطای غیرمجاز (403) را برمی‌گرداند. آن بخش‌ها فقط برای مالک ویدیو دردسترس است.

‫۱۷ مه ۲۰۱۶

ابزار جدید Data API Code Snippets تکه‌کدهای کوتاهی برای موارد استفاده رایج YouTube Data API ارائه می‌دهد. درحال‌حاضر تکه‌کدها برای همه روش‌های API فقط خواندنی در Apps Script،‏ Go،‏ JavaScript،‏ PHP،‏ Python، و Ruby دردسترس است.

برای هر روش، این ابزار نمونه کدهایی را برای یک یا چند مورد استفاده نشان می‌دهد. برای مثال، پنج تکه‌کد برای روش search.list ارائه می‌دهد:

  • فهرست کردن ویدیوها براساس کلیدواژه
  • فهرست کردن ویدیوها براساس مکان
  • فهرست کردن رویدادهای زنده
  • جستجوی ویدیوهای کاربر اصالت‌سنجی‌شده
  • فهرست کردن ویدیوهای مرتبط

برای هر مورد استفاده، این ابزار پارامترهای استفاده‌شده در درخواست API را نمایش می‌دهد. می‌توانید مقادیر پارامتر را تغییر دهید، در این صورت ابزار تکه‌کدها را به‌روز می‌کند تا مقادیر پارامتری را که ارائه کرده‌اید منعکس کند.

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

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

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

  • ویژگی جدید contentDetails.projection منبع video قالب نمایش ویدیو را مشخص می‌کند. مقادیر دارایی معتبر 360 و rectangular است.

  • ویژگی‌های recordingDetails.location و fileDetails.recordingLocation منبع video هر دو به‌روزرسانی شده‌اند تا تفاوت بین این دو ویژگی را توضیح دهند:

    • ویژگی recordingDetails.location مکانی را که مالک ویدیو می‌خواهد با ویدیو مرتبط کند شناسایی می‌کند. این مکان قابل‌ویرایش است، در ویدیوهای عمومی قابل‌جستجو است، و ممکن است برای ویدیوهای عمومی به کاربران نمایش داده شود.
    • مقدار دارایی fileDetails.recordingLocation تغییرناپذیر است و نشان‌دهنده مکان مرتبط با فایل ویدیویی اصلی بارگذاری‌شده است. این مقدار فقط برای مالک ویدیو قابل‌مشاهده است.

  • تعریف ویژگی contentDetails.relatedPlaylists.favorites منبع channel به‌روزرسانی شده است تا مشخص شود که مقدار ویژگی ممکن است حاوی شناسه فهرست پخشی باشد که به فهرست پخش خالی ارجاع می‌دهد و قابل واکشی نیست. این به این دلیل است که عملکرد ویدیوهای دلخواه قبلاً منسوخ شده است. توجه داشته باشید که این ویژگی مشمول خط‌مشی منسوخ کردن میانای برنامه‌سازی کاربردی نیست.

  • تعریف خطای ineligibleAccount، که می‌تواند توسط روش comments.insert، comments.update، commentThreads.insert، یا commentThreads.update برگردانده شود، به‌روزرسانی شده است تا نشان دهد که این خطا زمانی رخ می‌دهد که حساب YouTube استفاده‌شده برای مجوز دادن به درخواست API با حساب Google کاربر ادغام نشده باشد.

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

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

  • تعریف پارامتر part روش channels.update به‌روز شده است تا مشخص شود که localizations نیز مقدار معتبری برای آن پارامتر است.

  • بخش استفاده از سهمیه در راهنمای «شروع به کار» به‌روز شده است تا به «کنسول توسعه‌دهنده Google» پیوند داده شود، جایی که می‌توانید سهمیه واقعی و استفاده از سهمیه خود را ببینید.

‫۱۶ مارس ۲۰۱۶

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

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

    • سند منبع channelBanner به‌روزرسانی شده است تا اشاره کند که اندازه توصیه‌شده برای تصویر برنمای کانال بارگذاری‌شده ۲۵۶۰ پیکسل در ۱۴۴۰ پیکسل است. حداقل اندازه (۲۰۴۸ پیکسل در ۱۱۵۲ پیکسل) تغییر نکرده است.

    • ویژگی جدید snippet.customUrl منبع channel نشانی وب سفارشی مرتبط با کانال را شناسایی می‌کند. (همه کانال‌ها نشانی وب سفارشی ندارند.) مرکز راهنمایی YouTube شرایط صلاحیت برای دریافت نشانی وب سفارشی و همچنین نحوه راه‌اندازی نشانی وب را توضیح می‌دهد.

    • شیء brandingSettings.watch منبع channel و همه ویژگی‌های فرزند آن منسوخ شده است.

    • پاسخ میانای برنامه‌سازی کاربردی به درخواست search.list اکنون حاوی ویژگی regionCode است. این ویژگی کد منطقه‌ای را که برای پرسمان جستجو استفاده شده است شناسایی می‌کند. کد منطقه به API دستور می‌دهد تا نتایج جستجو را برای کشور مشخص‌شده برگرداند.

      مقدار ویژگی یک کد کشور دوحرفی ISO است که منطقه را مشخص می‌کند. روش i18nRegions.list فهرستی از مناطق پشتیبانی‌شده را برمی‌گرداند. مقدار پیش‌فرض US است. اگر منطقه‌ای غیراز مناطق پشتیبانی‌شده مشخص شود، YouTube ممکن است همچنان منطقه دیگری را به‌جای مقدار پیش‌فرض برای رسیدگی به پُرسمان انتخاب کند.

    • تعاریف ویژگی‌های snippet.label و snippet.secondaryReasons[].label منبع videoAbuseReportReason به‌روزرسانی شده‌اند تا نشان دهند که این ویژگی‌ها حاوی متن برچسب بومی‌سازی‌شده برای دلایل گزارش سوءاستفاده هستند.

      علاوه‌براین، روش videoAbuseReportReasons.list اکنون از پارامتر hl پشتیبانی می‌کند که زبانی را که باید برای نوشتار برچسب در پاسخ میانای برنامه‌سازی کاربردی استفاده شود مشخص می‌کند. مقدار پیش‌فرض پارامتر en_US است.

    • ویژگی جدید contentDetails.contentRating.ecbmctRating منبع video رده‌بندی ویدیو را از «هیئت ارزیابی و طبقه‌بندی وزارت فرهنگ و گردشگری ترکیه» شناسایی می‌کند.

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

      • contentDetails.contentRating.fpbRating (افریقای جنوبی)
        رتبه‌بندی: ۱۰؛ مقدار خصوصیت: fpb10
      • contentDetails.contentRating.moctwRating (تایوان)
        رده‌بندی: R-12؛ مقدار خصوصیت: moctwR12
      • contentDetails.contentRating.moctwRating (تایوان)
        رده‌بندی: R-15؛ مقدار خصوصیت: moctwR15

    • ویژگی liveStreamingDetails.activeLiveChatId منبع video حاوی شناسه گپ مستقیم فعال مرتبط با ویدیو است. مقدار ویژگی فقط درصورتی وجود دارد که ویدیو همه‌فرستی زنده فعلی باشد که گپ مستقیم در آن فعال شده است. پس‌از پایان همه‌فرستی و اتمام گپ مستقیم، این ویژگی دیگر برای ویدیو برگردانده نمی‌شود.

    • ویژگی status.rejectionReason منبع video از مقدار ویژگی جدید legal پشتیبانی می‌کند.

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

    نوع خطا جزئیات خطا شرح
    badRequest (400) notEditable روش‌های channelSections.insert، channelSections.update، و channelSections.delete این خطا را برمی‌گردانند تا نشان دهند که بخش کانال مشخص‌شده نمی‌تواند ایجاد، به‌روزرسانی، یا حذف شود.
    badRequest (400) styleRequired روش‌های channelSections.insert و channelSections.update این خطا را برمی‌گردانند تا نشان دهند که منبع channelSection ارسال‌شده در درخواست API باید مقداری برای ویژگی snippet.style مشخص کند.
    badRequest (400) typeRequired روش‌های channelSections.insert و channelSections.update این خطا را برمی‌گردانند تا نشان دهند که منبع channelSection ارسال‌شده در درخواست API باید مقداری برای ویژگی snippet.type مشخص کند.
    badRequest (400) processingFailure روش commentThreads.list این خطا را برمی‌گرداند تا نشان دهد سرور API نتوانسته است درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند گذرا باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است. ساختار منبع commentThread را در بدنه درخواست بررسی کنید تا مطمئن شوید معتبر است.
    forbidden (403) commentsDisabled روش commentThreads.list این خطا را برمی‌گرداند تا نشان دهد که ویدیو شناسایی‌شده توسط پارامتر videoId نظرات را غیرفعال کرده است.
    badRequest (400) commentTextTooLong روش commentThreads.insert این خطا را برمی‌گرداند تا نشان دهد منبع comment که درحال درج شدن است، نویسه‌های بسیار زیادی در ویژگی snippet.topLevelComment.snippet.textOriginal دارد.
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist روش playlistItems.insert این خطا را برمی‌گرداند تا نشان دهد ویدیویی که می‌خواهید به فهرست پخش اضافه کنید، درحال‌حاضر در رشته فهرست پخش دیگری قرار دارد. برای اطلاعات بیشتر درباره رشته فهرست‌های پخش، به مرکز راهنمایی YouTube مراجعه کنید.
    badRequest (400) subscriptionForbidden روش subscriptions.insert این خطا را برمی‌گرداند تا نشان دهد که به حداکثر تعداد اشتراک‌هایتان رسیده‌اید یا اخیراً اشتراک‌های زیادی ایجاد کرده‌اید. در حالت دوم، می‌توانید درخواست را پس‌از چند ساعت دوباره امتحان کنید.
    badRequest (400) invalidCategoryId روش videos.update این خطا را برمی‌گرداند تا نشان دهد که ویژگی snippet.categoryId در منبع video بارگذاری‌شده، شناسه دسته نامعتبری را مشخص کرده است. از روش videoCategories.list برای بازیابی دسته‌های پشتیبانی‌شده استفاده کنید.
    badRequest (400) invalidDescription روش videos.update این خطا را برمی‌گرداند تا نشان دهد که ویژگی snippet.description در منبع video بارگذاری‌شده مقدار نامعتبری را مشخص کرده است.
    badRequest (400) invalidPublishAt روش videos.update این خطا را برمی‌گرداند تا نشان دهد که ویژگی status.publishAt در منبع video بارگذاری‌شده، زمان انتشار زمان‌بندی‌شده نامعتبری را مشخص کرده است.
    badRequest (400) invalidRecordingDetails روش videos.update این خطا را برمی‌گرداند تا نشان دهد که شیء recordingDetails در منبع video بارگذاری‌شده جزئیات ضبط نامعتبری را مشخص کرده است.
    badRequest (400) invalidTags روش videos.update این خطا را برمی‌گرداند تا نشان دهد که ویژگی snippet.tags در منبع video بارگذاری‌شده مقدار نامعتبری را مشخص کرده است.
    badRequest (400) invalidTitle روش videos.update این خطا را برمی‌گرداند تا نشان دهد که ویژگی snippet.title در منبع بارگذاری‌شده video عنوان ویدیو نامعتبر یا خالی را مشخص کرده است.
    badRequest (400) invalidVideoMetadata روش videos.update این خطا را برمی‌گرداند تا نشان دهد فراداده درخواست نامعتبر است. این خطا زمانی رخ می‌دهد که درخواست، بخش snippet از منبع video را به‌روزرسانی کند اما مقداری برای هر دو ویژگی snippet.title و snippet.categoryId تنظیم نکند.

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

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

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

اکنون API از توانایی تنظیم و بازیابی نوشتار بومی‌سازی‌شده برای ویژگی‌های snippet.title و snippet.description منابع playlist و video، ویژگی snippet.title منبع channelSection، و ویژگی snippet.description منبع channel پشتیبانی می‌کند.

  • تنظیم عنوان‌ها و توضیحات بومی‌سازی‌شده

    هنگام فراخوانی روش insert یا update برای یک منبع، می‌توانید مقادیر بومی‌سازی‌شده را برای آن منبع تنظیم کنید. برای تنظیم مقادیر بومی‌سازی‌شده برای یک منبع، هر دو کار زیر را انجام دهید:

    • مطمئن شوید که مقداری برای ویژگی snippet.defaultLanguage منبع تنظیم شده باشد. این ویژگی زبان ویژگی‌های snippet.title و snippet.description منبع را مشخص می‌کند. مقدار آن می‌تواند هر زبان برنامه پشتیبانی‌شده یا اکثر کدهای زبان ISO 639-1:2002 دیگر باشد. برای مثال، اگر ویدیویی بارگذاری کنید که عنوان و شرح انگلیسی دارد، باید ویژگی snippet.defaultLanguage را روی en تنظیم کنید.

      نکته برای به‌روزرسانی منابع channel: برای تنظیم ویژگی snippet.defaultLanguage برای منبع channel، درواقع باید ویژگی brandingSettings.channel.defaultLanguage را به‌روز کنید.

    • شیء localizations را به منبعی که درحال به‌روزرسانی آن هستید اضافه کنید. هر کلید شیء رشته‌ای است که زبان برنامه یا کد زبان ISO 639-1:2002 را شناسایی می‌کند و هر کلید به شیئی نگاشت می‌شود که حاوی عنوان (و شرح) بومی‌سازی‌شده برای منبع است.

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

      {
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}

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

  • درحال بازیابی مقادیر بومی‌سازی‌شده

    این API از دو روش برای بازیابی مقادیر بومی‌سازی‌شده برای یک منبع پشتیبانی می‌کند:

    • پارامتر hl را به درخواست channels.list،‏ channelSections.list،‏ playlists.list، یا videos.list خود اضافه کنید تا داده‌های بومی‌سازی‌شده را برای زبان برنامه خاصی که وب‌سایت YouTube پشتیبانی می‌کند بازیابی کنید. اگر جزئیات منبع بومی‌سازی‌شده به آن زبان دردسترس باشد، شیء snippet.localized منبع حاوی مقادیر بومی‌سازی‌شده خواهد بود. بااین‌حال، اگر جزئیات بومی‌سازی‌شده دردسترس نباشد، شیء snippet.localized حاوی جزئیات منبع به زبان پیش‌فرض منبع خواهد بود.

      برای مثال، فرض کنید یک درخواست videos.list داده‌های مربوط به ویدیوی شرح داده شده در بالا را با داده‌های بومی‌سازی شده آلمانی و اسپانیایی بازیابی کرده است. اگر پارامتر hl روی de تنظیم شده باشد، منبع حاوی داده‌های زیر خواهد بود:

      {
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    "localized": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    }
    ...
  }
}

      اما اگر پارامتر hl روی fr تنظیم شده باشد، شیء snippet.localized حاوی عنوان و شرح انگلیسی خواهد بود زیرا انگلیسی زبان پیش‌فرض منبع است و جزئیات بومی‌سازی‌شده فرانسوی دردسترس نیست.

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

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

    • هنگام بازیابی منبع، localizations را در مقدار پارامتر part اضافه کنید تا همه جزئیات بومی‌سازی‌شده برای آن منبع بازیابی شود. اگر داده‌های بومی‌سازی‌شده را برای زبانی بازیابی می‌کنید که زبان فعلی برنامه YouTube نیست، باید از این رویکرد برای بازیابی همه بومی‌سازی‌ها استفاده کنید و سپس فیلتر کنید تا مشخص شود آیا داده‌های بومی‌سازی‌شده موردنظر وجود دارد یا نه.

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

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

    نوع خطا جزئیات خطا شرح
    badRequest (400) defaultLanguageNotSetError این خطا نشان می‌دهد که درخواستی که تلاش می‌کند شیء localizations را برای منبعی درج یا به‌روزرسانی کند ناموفق است زیرا ویژگی snippet.defaultLanguage برای آن منبع تنظیم نشده است. روش‌های channels.update، channelSections.insert، channelSections.update، playlists.insert، playlists.update، videos.insert، و videos.update از این خطا پشتیبانی می‌کنند.
    badRequest (400) localizationValidationError این خطا نشان می‌دهد که یکی از مقادیر در شیء localizations منبع اعتبارسنجی نشده است. برای مثال، اگر شیء حاوی کد زبان نامعتبر باشد، ممکن است این خطا رخ دهد. روش‌های channels.update،‏ channelSections.insert،‏ channelSections.update،‏ playlists.insert، و playlists.update از این خطا پشتیبانی می‌کنند.

۴ نوامبر ۲۰۱۵

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

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

    • پارامتر order روش search.list به‌روز شده است تا نشان دهد که اگر پخش‌های زنده را براساس viewCount مرتب کنید، نتایج API براساس تعداد بینندگان هم‌زمان پخش‌ها درحالی‌که پخش‌ها هنوز ادامه دارند مرتب می‌شوند.

    • پارامتر relatedToVideoId روش search.list به‌روزرسانی شده است تا مشخص شود که اگر پارامتر تنظیم شده باشد، تنها پارامترهای پشتیبانی‌شده دیگر part، maxResults، pageToken، regionCode، relevanceLanguage، safeSearch، type (که باید روی video تنظیم شود)، و fields هستند. این به‌روزرسانی نشان‌دهنده تغییری در رفتار میانای برنامه‌سازی کاربردی نیست.

    • تعریف ویژگی snippet.publishedAt منبع video به‌روزرسانی شده است تا مشخص شود که مقدار ویژگی، که تاریخ و زمان انتشار ویدیو را مشخص می‌کند، ممکن است با زمان بارگذاری ویدیو متفاوت باشد. برای مثال، اگر ویدیویی به‌عنوان ویدیو خصوصی بارگذاری شود و سپس در زمان دیگری عمومی شود، مقدار ویژگی زمانی را مشخص می‌کند که ویدیو عمومی شده است. تعریف به‌روزشده همچنین توضیح می‌دهد که چگونه مقدار برای ویدیوهای خصوصی و فهرست‌نشده پر می‌شود.

      این تغییر نشان‌دهنده تغییر در رفتار میانای برنامه‌سازی کاربردی نیست.

    • تعریف ویژگی status.publishAt منبع video به‌روزرسانی شده است تا به این نکته اشاره کند:

      • اگر هنگام فراخوانی روش videos.update مقدار این ویژگی را تنظیم کنید، باید مقدار ویژگی status.privacyStatus را نیز روی private تنظیم کنید، حتی اگر ویدیو ازقبل خصوصی باشد.
      • اگر درخواست، ویدیویی را برای انتشار در زمانی در گذشته زمان‌بندی کند، ویدیو بلافاصله منتشر می‌شود. بنابراین، تأثیر تنظیم خصوصیت status.publishAt روی تاریخ و زمان گذشته مانند تغییر privacyStatus ویدیو از private به public است.

    • ویژگی contentDetails.contentRating.cncRating منبع video رده‌بندی ویدیو را از Commission de classification cinematographique فرانسه مشخص می‌کند. این خصوصیت جایگزین خصوصیت contentDetails.contentRating.fmocRating می‌شود که اکنون منسوخ شده است.

    • تعریف brandingSettings.channel.keywords منبع channel به‌روزرسانی شده است تا به‌درستی نشان دهد که مقدار ویژگی حاوی فهرستی از رشته‌های جداشده با فاصله است و نه فهرستی جداشده با کاما، همان‌طور که قبلاً مستند شده بود. این به‌روزرسانی نشان‌دهنده تغییری در رفتار میانای برنامه‌سازی کاربردی نیست.

    • اسناد مربوط به روش thumbnails.set به‌روزرسانی شده است تا به‌طور دقیق نشان دهد که بدنه درخواست حاوی تصویر کوچک است که شما بارگذاری می‌کنید و با ویدیو مرتبط می‌کنید. متن درخواست حاوی منبع thumbnail نیست. قبلاً در اسناد گفته شده بود که هنگام فراخوانی این روش نباید بدنه درخواست ارائه دهید. این به‌روزرسانی نشان‌دهنده تغییری در رفتار میانای برنامه‌سازی کاربردی نیست.

    • توضیحات منبع activity به‌روزرسانی شده است تا نشان دهد که روش activities.list درحال‌حاضر شامل منابع مربوط به نظرات جدید ویدیو نمی‌شود. snippet.type و contentDetails.comment منبع نیز به‌روز شده است.

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

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

      جزئیات خطا
      activities.insert
      کد پاسخ HTTPbadRequest (400)
      استدلالinvalidMetadata
      شرحمشخصه kind با نوع شناسه ارائه‌شده مطابقت ندارد.
      commentThreads.update
      comments.insert
      comments.update
      کد پاسخ HTTPbadRequest (400)
      استدلالcommentTextTooLong
      شرحمنبع comment که درحال درج یا به‌روزرسانی است، نویسه‌های بسیار زیادی در ویژگی snippet.topLevelComment.snippet.textOriginal دارد.
      playlistItems.insert
      playlistItems.update
      کد پاسخ HTTPforbidden (403)
      استدلالplaylistItemsNotAccessible
      شرحدرخواست برای درج، به‌روزرسانی، یا حذف مورد فهرست پخش مشخص‌شده به‌درستی مجاز نشده است.
      playlists.delete
      playlists.insert
      playlists.update
      کد پاسخ HTTPbadRequest (400)
      استدلالplaylistForbidden
      شرحاین عملیات ممنوع است یا درخواست به‌درستی مجاز نشده است.
      search.list
      کد پاسخ HTTPbadRequest (400)
      استدلالinvalidLocation
      شرحقالب‌بندی مقدار پارامتر location و/یا locationRadius نادرست بود.
      search.list
      کد پاسخ HTTPbadRequest (400)
      استدلالinvalidRelevanceLanguage
      شرحقالب‌بندی مقدار پارامتر relevanceLanguage نادرست بود.
      subscriptions.insert
      کد پاسخ HTTPbadRequest (400)
      استدلالsubscriptionForbidden
      شرح این خطا زمانی رخ می‌دهد که یکی از موارد زیر درست باشد:
      • اشتراکی که می‌خواهید ایجاد کنید ازقبل وجود دارد
      • درحال‌حاضر به حداکثر تعداد اشتراک‌هایتان رسیده‌اید
      • شما در تلاشید تا در کانال خودتان مشترک شوید که این کار پشتیبانی نمی‌شود.
      • اخیراً اشتراک‌های زیادی ایجاد کرده‌اید و باید چند ساعت صبر کنید و سپس درخواست را دوباره امتحان کنید.
      videos.update
      کد پاسخ HTTPbadRequest (400)
      استدلالinvalidDefaultBroadcastPrivacySetting
      شرحدرخواست تلاش می‌کند تنظیم حریم خصوصی نامعتبری برای همه‌فرستی پیش‌فرض تنظیم کند.

‫۲۸ اوت ۲۰۱۵

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

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

    • خصوصیت statistics.favoriteCount منبع video منسوخ شده است.

      مطابق با خط‌مشی منسوخ کردن ما، این ویژگی حداقل تا یک سال پس‌از این اعلامیه همچنان در منابع video گنجانده خواهد شد. اما اکنون مقدار ویژگی همیشه روی 0 تنظیم می‌شود.

۷ اوت ۲۰۱۵

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

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

    • تعریف ویژگی snippet.tags[] منبع video به‌روز شده است تا اطلاعات بیشتری درباره نحوه محاسبه طول مقدار ویژگی توسط سرور میانای برنامه‌سازی کاربردی ارائه شود. توجه داشته باشید که این به‌روزرسانی نشان‌دهنده تغییری در رفتار میانای برنامه‌سازی کاربردی نیست.

      به‌طور دقیق‌تر، اکنون در تعریف توضیح داده شده است که اگر برچسبی حاوی فاصله باشد، سرور API با مقدار برچسب طوری رفتار می‌کند که گویی در علامت نقل‌قول قرار دارد و علامت‌های نقل‌قول در حد نویسه محاسبه می‌شوند. بنابراین، برای اهداف حد نویسه، برچسب Foo-Baz شامل هفت نویسه است، اما برچسب Foo Baz شامل نه نویسه است.

    • روش commentThreads.insert دیگر از پارامتر shareOnGooglePlus پشتیبانی نمی‌کند، که قبلاً نشان می‌داد آیا نظر و پاسخ‌های آن نظر باید در نمایه Google+‎ نویسنده نیز پست شود یا نه. اگر درخواستی پارامتر را ارسال کند، سرور API پارامتر را نادیده می‌گیرد اما درغیراین‌صورت درخواست را مدیریت می‌کند.

‫۱۸ ژوئن ۲۰۱۵

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

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

    • پارامتر جدید order در روش commentThreads.list مشخص می‌کند که پاسخ میانای برنامه‌سازی کاربردی باید رشته‌های نظر را به چه ترتیبی فهرست کند. رشته‌ها را می‌توان براساس زمان یا مربوط بودن مرتب کرد. رفتار پیش‌فرض این است که آن‌ها را براساس زمان مرتب کند.

    • ویژگی جدید snippet.defaultAudioLanguage منبع video زبانی را که در قطعه صوتی پیش‌فرض ویدیو صحبت می‌شود مشخص می‌کند.

    • تعریف ویژگی contentDetails.licensedContent منبع video به‌روزرسانی شده است تا روشن شود که محتوا باید در ابتدا در کانالی بارگذاری شده باشد که به شریک محتوای YouTube پیوند شده است و سپس توسط آن شریک ادعا شده باشد. این نشان‌دهنده تغییری در رفتار واقعی میانای برنامه‌سازی کاربردی نیست.

    • روش‌های captions.delete،‏ captions.download،‏ captions.insert،‏ captions.list، و captions.update اکنون از پارامتر onBehalfOfContentOwner پشتیبانی می‌کنند که قبلاً برای چندین روش دیگر پشتیبانی می‌شد. درخواست‌هایی که از این روش استفاده می‌کنند باید با یک توکن که دسترسی به دامنه https://www.googleapis.com/auth/youtubepartner را فراهم می‌کند، مجاز شوند.

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

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

      جزئیات خطا
      videos.rate
      کد پاسخ HTTPbadRequest (400)
      استدلالemailNotVerified
      شرحکاربر باید پیش‌از رده‌بندی ویدیو، نشانی ایمیل خود را درستی‌سنجی کند.
      videos.rate
      کد پاسخ HTTPbadRequest (400)
      استدلالvideoPurchaseRequired
      شرحویدیوهای کرایه‌ای را فقط کاربرانی که آن‌ها را کرایه کرده‌اند می‌توانند رده‌بندی کنند.

    • روش‌های subscriptions.delete و subscriptions.insert دیگر از خطاهای accountClosed و accountSuspended پشتیبانی نمی‌کنند.

‫۲۷ آوریل ۲۰۱۵

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

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

    • منبع جدید videoAbuseReportReason حاوی اطلاعاتی درباره دلیل پرچم‌گذاری ویدیو به‌دلیل داشتن محتوای سوءاستفاده‌گرانه است. روش videoAbuseReportReasons.list به شما امکان می‌دهد فهرستی از تمام دلایلی که ممکن است ویدیوها پرچم‌گذاری شوند را بازیابی کنید.

    • روش جدید videos.reportAbuse راهی برای پرچم‌گذاری واقعی ویدیوهایی که حاوی محتوای سوءاستفاده‌گرانه هستند ارائه می‌دهد. بدنه درخواست حاوی یک شیء JSON است که ویدیوی پرچم‌گذاری‌شده و همچنین دلیل اینکه ویدیو حاوی محتوای سوءاستفاده‌گرانه تلقی می‌شود را مشخص می‌کند. دلایل معتبر را می‌توان از روش videoAbuseReportReason.list که در بالا توضیح داده شده است دریافت کرد.

      راهنمای انتقال نیز با مثالی برای گزارش کردن ویدیو سوءاستفاده‌گرانه به‌روز شده است. با این تغییر، v3 API اکنون از همه ویژگی‌های v2 API که قرار است پشتیبانی کند پشتیبانی می‌کند. همه این ویژگی‌ها در راهنمای انتقال نیز توضیح داده شده‌اند.

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

    • پارامتر فیلتر جدید forDeveloper در روش search.list جستجو را محدود می‌کند تا فقط ویدیوهای بارگذاری‌شده ازطریق برنامه یا وب‌سایت توسعه‌دهنده را بازیابی کند. پارامتر forDeveloper را می‌توان همراه با پارامترهای جستجوی اختیاری مانند پارامتر q استفاده کرد.

      برای این ویژگی، هر ویدیو بارگذاری‌شده به‌طور خودکار با شماره پروژه‌ای که با برنامه توسعه‌دهنده در کنسول توسعه‌دهندگان Google مرتبط است، برچسب‌گذاری می‌شود.

      وقتی درخواست جستجو متعاقباً پارامتر forDeveloper را روی true تنظیم می‌کند، سرور API از اطلاعات اعتباری مجوز درخواست برای شناسایی توسعه‌دهنده استفاده می‌کند. بنابراین، توسعه‌دهنده می‌تواند نتایج را به ویدیوهای بارگذاری‌شده ازطریق برنامه یا وب‌سایت خود توسعه‌دهنده محدود کند، اما نمی‌تواند به ویدیوهای بارگذاری‌شده ازطریق برنامه‌ها یا سایت‌های دیگر محدود کند.

      ویژگی جدید عملکردی مشابه، هرچند نه کاملاً یکسان، با عملکرد برچسب‌های توسعه‌دهنده که میانای برنامه‌سازی کاربردی v2 پشتیبانی می‌کرد ارائه می‌دهد.

    • ویژگی جدید snippet.country منبع channel به مالکان کانال اجازه می‌دهد کانال‌هایشان را با کشور خاصی مرتبط کنند.

      توجه: برای تنظیم ویژگی snippet.country برای منبع channel، درواقع باید ویژگی brandingSettings.channel.country را به‌روز کنید.

    • این میانای برنامه‌سازی کاربردی اکنون از هدف‌یابی برای منابع channelSection پشتیبانی می‌کند. هدف‌یابی بخش کانال راهی برای محدود کردن رؤیت‌پذیری بخش محتوا برای کاربرانی است که با معیارهای خاصی مطابقت دارند.

      این API سه گزینه هدف‌یابی را ارائه می‌دهد. کاربر باید همه تنظیمات هدف‌یابی را داشته باشد تا بخش کانال قابل‌مشاهده باشد.

    • تعریف ویژگی contentDetails.duration منبع video اصلاح شده است تا نشان دهد که این مقدار می‌تواند نشان‌دهنده ساعت، روز، و غیره باشد.

    • اسناد مربوط به روش channelSections.delete،‏ playlistItems.delete،‏ playlists.delete،‏ subscriptions.delete، و videos.delete اصلاح شده است تا نشان دهد که درصورت موفقیت، همه این روش‌ها کد پاسخ HTTP 204 (No Content) را برمی‌گردانند.

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

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

      نوع خطا جزئیات خطا شرح
      badRequest (400) targetInvalidCountry اگر منبع channelSection درج‌شده حاوی مقدار نامعتبری برای ویژگی targeting.countries[] باشد، روش‌های channelSections.insert و channelSections.update این خطا را برمی‌گردانند.
      badRequest (400) targetInvalidLanguage اگر منبع channelSection درج‌شده حاوی مقدار نامعتبری برای ویژگی targeting.languages[] باشد، روش‌های channelSections.insert و channelSections.update این خطا را برمی‌گردانند.
      badRequest (400) targetInvalidRegion اگر منبع channelSection درج‌شده حاوی مقدار نامعتبری برای ویژگی targeting.regions[] باشد، روش‌های channelSections.insert و channelSections.update این خطا را برمی‌گردانند.
      badRequest (400) operationNotSupported اگر کاربر API نتواند نظری را در پاسخ به نظر سطح بالایی که با ویژگی snippet.parentId شناسایی شده است درج کند، روش comments.insert این خطا را برمی‌گرداند. در منبع commentThread، ویژگی snippet.canReply نشان می‌دهد که آیا بیننده فعلی می‌تواند به رشته پاسخ دهد یا نه.
      badRequest (400) invalidChannelId اگر پارامتر channelId در درخواست شناسه کانال نامعتبری را مشخص کرده باشد، روش search.list این خطا را برمی‌گرداند.
      badRequest (400) subscriptionForbidden اگر کاربر API تلاش کند در کانال خود کاربر مشترک شود، روش subscriptions.insert این خطا را برمی‌گرداند.

    • روش captions.update دیگر از خطاهای invalidMetadata و videoNotFound پشتیبانی نمی‌کند.

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

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

  • راهنمای انتقال به‌روز شده است تا نحوه انتقال برنامه‌هایی را که هنوز از عملکرد نظرات میانای برنامه‌سازی کاربردی نسخه ۲ استفاده می‌کنند توضیح دهد.

    این راهنما همچنین چندین ویژگی نظر دادن را که میانای برنامه‌سازی کاربردی v2 پشتیبانی نمی‌کرد اما در میانای برنامه‌سازی کاربردی v3 پشتیبانی می‌شود، معرفی می‌کند. این موارد عبارت‌اند از:

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

  • راهنمای مشترک شدن در اعلان‌های لحظه‌ای به‌روزرسانی شده است تا این واقعیت را نشان دهد که اعلان‌ها فقط به مرکز Google PubSubHubBub ارسال می‌شوند و نه به مرکز Superfeedr، همان‌طور که قبلاً نشان داده شده بود.

‫۹ آوریل ۲۰۱۵

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

  • منابع جدید commentThread و comment در API به شما امکان می‌دهند نظرات را بازیابی، درج، به‌روزرسانی، حذف، و تعدیل کنید.

    • منبع commentThread حاوی اطلاعاتی درباره رشته نظرات YouTube است که شامل نظر سطح بالا و پاسخ‌ها به آن نظر (درصورت وجود) می‌شود. منبع commentThread می‌تواند نشان‌دهنده نظرات درباره ویدیو یا کانال باشد.

      نظر سطح بالا و پاسخ‌ها درواقع منابع comment هستند که در منبع commentThread تودرتو شده‌اند. توجه به این نکته مهم است که منبع commentThread لزوماً شامل همه پاسخ‌های یک نظر نیست و اگر می‌خواهید همه پاسخ‌های یک نظر خاص را بازیابی کنید، باید از روش comments.list استفاده کنید. به‌علاوه، برخی‌از نظرات پاسخی ندارند.

      میانای برنامه‌سازی کاربردی از روش‌های زیر برای منابع commentThread پشتیبانی می‌کند:

      • commentThreads.list – بازیابی فهرستی از رشته‌های نظرات. از این روش برای بازیابی نظرات مرتبط با یک ویدیو یا کانال خاص استفاده کنید.
      • commentThreads.insert – ایجاد نظر سطح بالا جدید. (از روش comments.insert برای پاسخ دادن به نظر موجود استفاده کنید.)
      • commentThreads.update – اصلاح نظر سطح بالا.

    • منبع comment حاوی اطلاعاتی درباره یک نظر YouTube است. منبع comment می‌تواند نشان‌دهنده نظری درباره ویدیو یا کانال باشد. علاوه‌براین، نظر می‌تواند یک نظر سطح بالا یا پاسخی به یک نظر سطح بالا باشد.

      میانای برنامه‌سازی کاربردی از روش‌های زیر برای منابع comment پشتیبانی می‌کند:

      • comments.list – بازیابی فهرست نظرات. از این روش برای بازیابی همه پاسخ‌های یک نظر خاص استفاده کنید.
      • comments.insert – ایجاد پاسخ به نظر موجود.
      • comments.update – اصلاح نظر.
      • comments.markAsSpam – یک یا چند نظر را به‌عنوان هرزنامه پرچم‌گذاری کنید.
      • comments.setModerationStatus – وضعیت تعدیل یک یا چند نظر را تنظیم کنید. برای مثال، نظری را برای نمایش عمومی تأیید کنید یا نظری را به‌دلیل نامناسب بودن برای نمایش رد کنید. درخواست API باید توسط مالک کانال یا ویدیوی مرتبط با نظرات مجاز شود.
      • comments.delete – حذف نظر.

    توجه داشته باشید که گستره جدید https://www.googleapis.com/auth/youtube.force-ssl میانای برنامه‌سازی کاربردی، که در سابقه ویرایش ۲ آوریل ۲۰۱۵ شرح داده شده است، برای فراخوانی روش‌های comments.insert، comments.update، comments.markAsSpam، comments.setModerationStatus، comments.delete، commentThreads.insert، و commentThreads.update لازم است.

  • راهنمای جدید مشترک شدن در اعلان‌های لحظه‌ای پشتیبانی جدید میانای برنامه‌سازی کاربردی از اعلان‌های لحظه‌ای را ازطریق PubSubHubBub (یک پروتکل انتشار/اشتراک سروربه‌سرور برای منابع قابل‌دسترسی در وب) توضیح می‌دهد. وقتی کانالی هریک از فعالیت‌های زیر را انجام دهد، سرور callback PubSubHubBub شما می‌تواند اعلان‌های فید Atom را دریافت کند:

    • ویدیویی بارگذاری می‌کند
    • عنوان ویدیو را به‌روز می‌کند
    • شرح ویدیو را به‌روزرسانی می‌کند

  • راهنمای انتقال نیز به‌روز شده است تا پشتیبانی جدید از اعلان‌های لحظه‌ای را ذکر کند. بااین‌حال، ازآنجایی‌که v2 API از انواع متعدد دیگری از اعلان‌های لحظه‌ای پشتیبانی می‌کرد که در v3 API پشتیبانی نمی‌شوند، اشاره به پشتیبانی PubSubHubBub هنوز در بخش منسوخ‌شده آن راهنما فهرست شده است.

  • گستره جدید https://www.googleapis.com/auth/youtube.force-ssl در میانای برنامه‌سازی کاربردی اکنون گستره معتبری برای هر روش میانای برنامه‌سازی کاربردی است که قبلاً از گستره https://www.googleapis.com/auth/youtube پشتیبانی می‌کرد.

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

    نوع خطا جزئیات خطا شرح
    badRequest (400) invalidRating اگر درخواست حاوی مقدار غیرمنتظره‌ای برای پارامتر rating باشد، روش videos.rate این خطا را برمی‌گرداند.

  • روش subscriptions.insert دیگر از خطای subscriptionLimitExceeded پشتیبانی نمی‌کند، که قبلاً نشان می‌داد مشترک شناسایی‌شده با درخواست از حد نرخ اشتراک فراتر رفته است.

‫۲ آوریل ۲۰۱۵

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

  • منبع جدید captions نشان‌دهنده قطعه زیرنویس ناشنوایان YouTube است. یک قطعه زیرنویس ناشنوایان دقیقاً با یک ویدیو YouTube مرتبط است.

    این API از روش‌هایی برای فهرست کردن، درج کردن، به‌روزرسانی کردن، بارگیری کردن، و حذف کردن قطعه‌های زیرنویس ناشنوایان پشتیبانی می‌کند.

  • راهنمای انتقال نیز به‌روز شده است تا نحوه انتقال برنامه‌هایی را که هنوز از عملکرد زیرنویس ناشنوایان در میانای برنامه‌سازی کاربردی نسخه ۲ استفاده می‌کنند توضیح دهد.

  • گستره جدید https://www.googleapis.com/auth/youtube.force-ssl میانای برنامه‌سازی کاربردی مستلزم این است که ارتباط با سرور میانای برنامه‌سازی کاربردی ازطریق اتصال SSL انجام شود.

    این گستره جدید همان دسترسی گستره https://www.googleapis.com/auth/youtube را اعطا می‌کند. و درواقع، این دو دامنه از نظر عملکردی یکسان هستند زیرا سرور YouTube API فقط ازطریق نقطه پایانی HTTPS دردسترس است. درنتیجه، اگرچه دامنه https://www.googleapis.com/auth/youtube به اتصال SSL نیاز ندارد، درواقع هیچ راه دیگری برای درخواست API وجود ندارد.

    گستره جدید برای تماس با همه روش‌های منبع caption لازم است.

‫۱۱ مارس ۲۰۱۵

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

  • راهنمای انتقال YouTube Data API (v3) حاوی برگه جدیدی به‌نام جدید در v3 API است که ویژگی‌هایی را فهرست می‌کند که v3 API پشتیبانی می‌کند و v2 API پشتیبانی نمی‌کرد. همین ویژگی‌ها قبلاً در برگه‌های دیگر راهنما فهرست شده بودند و هنوز هم فهرست شده‌اند. برای مثال، ویژگی جدیدی که نحوه به‌روزرسانی داده‌های پویش تبلیغاتی درون‌ویدیویی کانال را توضیح می‌دهد، در برگه کانال‌ها (نمایه‌ها) نیز فهرست شده است.

  • راهنمای انتقال YouTube Data API (v3) به‌روزرسانی شده است تا نشان دهد که v3 API از ویژگی v2 API زیر پشتیبانی خواهد کرد:

  • راهنمای انتقال YouTube Data API (نسخه ۳) به‌روزرسانی شده است تا اشاره کند که ویژگی‌های زیر از میانای برنامه‌سازی کاربردی نسخه ۲ در میانای برنامه‌سازی کاربردی نسخه ۳ پشتیبانی نخواهند شد:

    • بازیابی توصیه‌های ویدیویی – API نسخه ۳ فهرستی را که فقط شامل ویدیوهای توصیه‌شده برای کاربر فعلی API باشد بازیابی نمی‌کند. بااین‌حال، می‌توانید از API نسخه ۳ برای یافتن ویدیوهای توصیه‌شده با فراخوانی روش activities.list و تنظیم مقدار پارامتر home روی true استفاده کنید.

      در پاسخ میانای برنامه‌سازی کاربردی، اگر مقدار ویژگی snippet.type برابر با recommendation باشد، منبع با ویدیو توصیه‌شده مطابقت دارد. در این صورت، ویژگی‌های contentDetails.recommendation.reason و contentDetails.recommendation.seedResourceId حاوی اطلاعاتی درباره دلیل توصیه شدن ویدیو خواهند بود. توجه داشته باشید که هیچ تضمینی وجود ندارد که پاسخ حاوی تعداد مشخصی از ویدیوهای توصیه‌شده باشد.

    • بازیابی پیشنهادهای کانال

    • بازیابی ویدیوهای اشتراک جدید – API نسخه ۳ فهرستی را که فقط حاوی ویدیوهایی است که اخیراً در کانال‌هایی که کاربر API در آن‌ها مشترک است بارگذاری شده‌اند، بازیابی نمی‌کند. بااین‌حال، می‌توانید از میانای برنامه‌سازی کاربردی نسخه ۳ برای یافتن ویدیوهای اشتراک جدید با فراخوانی روش activities.list و تنظیم مقدار پارامتر home روی true استفاده کنید.

      در پاسخ میانای برنامه‌سازی کاربردی، اگر مقدار ویژگی snippet.type برابر با upload باشد، منبع با ویدیو اشتراک جدید مطابقت دارد. توجه داشته باشید که هیچ تضمینی وجود ندارد که پاسخ حاوی تعداد خاصی از ویدیوهای اشتراک جدید باشد.

    • پشتیبانی فید RSS

    • اعلان‌های لحظه‌ای برای به‌روزرسانی‌های فید – API نسخه ۲ از اعلان‌های لحظه‌ای بااستفاده از «پروتکل به‌روزرسانی ساده» (SUP) یا PubSubHubbub برای نظارت بر فیدهای فعالیت کاربر برای کاربران YouTube پشتیبانی می‌کرد. اعلان‌ها برای اشتراک‌های جدید کانال و زمانی که ویدیوها رتبه‌بندی، هم‌رسانی، به‌عنوان موارد دلخواه علامت‌گذاری، نظر داده شده یا بارگذاری می‌شدند، ارائه می‌شدند.

      میانای برنامه‌سازی کاربردی نسخه ۳ از اعلان‌های لحظه‌ای بااستفاده از پروتکل PubSubHubbub پشتیبانی می‌کند، اما این اعلان‌ها فقط بارگذاری ویدیو و به‌روزرسانی عنوان یا شرح ویدیو را پوشش می‌دهند.

    • مکان کانال – API نسخه ۲ از برچسب <yt:location> برای شناسایی مکان کاربر، همان‌طور که در نمایه عمومی YouTube کانال وارد شده است، استفاده می‌کرد. اگرچه برخی‌از توسعه‌دهندگان از این فیلد برای مرتبط کردن کانال با کشوری خاص استفاده می‌کردند، اما داده‌های این فیلد نمی‌توانست به‌طور مداوم برای این منظور استفاده شود.

    • تنظیم یا بازیابی برچسب‌های توسعه‌دهنده – میانای برنامه‌سازی کاربردی نسخه v2 از قابلیت مرتبط کردن کلیدواژه‌ها یا برچسب‌های توسعه‌دهنده با ویدیو در زمان بارگذاری ویدیو پشتیبانی می‌کرد. برچسب‌های توسعه‌دهنده به کاربران YouTube نمایش داده نمی‌شدند، اما مالکان ویدیو می‌توانستند ویدیوهایی را که با یک برچسب توسعه‌دهنده خاص مطابقت داشتند بازیابی کنند.

      میانای برنامه‌سازی کاربردی v3 ویژگی مشابه، اما نه یکسانی، ارائه خواهد داد. به‌طور خاص، توسعه‌دهنده می‌تواند ویدیوهای بارگذاری‌شده توسط برنامه خود را جستجو کند. برای این ویژگی، هر ویدیو بارگذاری‌شده به‌طور خودکار با شماره پروژه‌ای که با برنامه توسعه‌دهنده در کنسول توسعه‌دهندگان Google مرتبط است، برچسب‌گذاری می‌شود. سپس توسعه‌دهنده از همان شماره پروژه برای جستجوی ویدیوها استفاده می‌کند.

    • فهرست کردن ویدیوها براساس تاریخ انتشار، تعداد بازدید، یا رده‌بندی – در v2 API، پارامتر orderby به شما امکان می‌داد ویدیوها را در فهرست پخش براساس موقعیت، مدت، تاریخ انتشار، عنوان، و چند مقدار دیگر مرتب کنید. در API نسخه ۳، موارد فهرست پخش معمولاً براساس موقعیت به‌ترتیب صعودی مرتب می‌شوند و گزینه‌های مرتب‌سازی دیگر دردسترس نیستند.

      چند استثنا وجود دارد. یک بارگذاری جدید، ویدیو دلخواه، ویدیو پسندیده شده، یا ویدیو اخیراً تماشا شده به‌طور خودکار به‌عنوان اولین مورد (snippet.position=0) برای انواع فهرست‌های پخش زیر اضافه می‌شود. بنابراین، هریک از این فهرست‌ها به‌طور مؤثر براساس زمان اضافه شدن موارد به فهرست، از جدیدترین به قدیمی‌ترین مورد مرتب شده‌اند.

      • بارگذاری‌های کاربر
      • ویدیوهای دلخواه
      • ویدیوهای پسندیده شده
      • سابقه تماشا

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

    • پردازش دسته‌ای – میانای برنامه‌سازی کاربردی نسخه ۳ از یکی از موارد استفاده پردازش دسته‌ای که میانای برنامه‌سازی کاربردی نسخه ۲ پشتیبانی می‌کرد، پشتیبانی می‌کند. روش‌های channels.list، channelSections.list، guideCategories.list، playlistItems.list، playlists.list، subscriptions.list، videoCategories.list، و videos.list در v3 API همگی از پارامتر id پشتیبانی می‌کنند که می‌توان از آن برای مشخص کردن فهرست شناسه‌های جداشده با ویرگول (شناسه‌های ویدیو، شناسه‌های کانال، و غیره) استفاده کرد. بااستفاده از این روش‌ها، می‌توانید فهرستی از چندین منبع را با یک درخواست بازیابی کنید.

    با این تغییرات، راهنما اکنون تمام عملکردهایی را که در «میانای برنامه‌سازی کاربردی» قدیمی (v2) پشتیبانی می‌شد و در نسخه فعلی «میانای برنامه‌سازی کاربردی» (v3) منسوخ خواهد شد شناسایی می‌کند.

۴ مارس ۲۰۱۵

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

  • روش‌های channelSections.delete و channelSections.update اکنون از پارامتر onBehalfOfContentOwner پشتیبانی می‌کنند که قبلاً برای چندین روش دیگر پشتیبانی می‌شد.

  • دارایی‌های زیر و دارایی‌های فرزند آن‌ها منسوخ شده‌اند:

    • brandingSettings.image.backgroundImageUrl
    • brandingSettings.image.largeBrandedBannerImageImapScript
    • brandingSettings.image.largeBrandedBannerImageUrl
    • brandingSettings.image.smallBrandedBannerImageImapScript
    • brandingSettings.image.smallBrandedBannerImageUrl

    توجه: هیچ‌کدام از این دارایی‌ها مشمول «خط‌مشی منسوخ کردن میانای برنامه‌سازی کاربردی» نبوده‌اند.

  • ویژگی جدید contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons منبع video دلایلی را مشخص می‌کند که توضیح می‌دهد چرا ویدیو رده‌بندی DJCQT (برزیل) را دریافت کرده است.

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

    نوع خطا جزئیات خطا شرح
    notFound (404) channelNotFound اگر پارامتر id درخواست کانالی را مشخص کند که پیدا نمی‌شود، روش channels.update این خطا را برمی‌گرداند.
    badRequest (400) manualSortRequiredinvalidValue اگر درخواست تلاش کند جایگاه مورد فهرست پخش را تنظیم کند، اما فهرست پخش از مرتب‌سازی دستی استفاده نکند، روش‌های playlistItems.insert و playlistItems.update این خطا را برمی‌گردانند. برای مثال، موارد فهرست پخش ممکن است براساس تاریخ یا محبوبیت مرتب شوند. می‌توانید این خطا را با برداشتن عنصر snippet.position از منبع ارسال‌شده در بدنه درخواست برطرف کنید. اگر می‌خواهید مورد فهرست پخش جایگاه خاصی در فهرست داشته باشد، ابتدا باید تنظیم ترتیب فهرست پخش را به دستی به‌روز کنید. این تنظیم را می‌توان در مدیر ویدیو YouTube تغییر داد.
    forbidden (403) channelClosed اگر پارامتر channelId درخواست کانالی را مشخص کند که بسته شده است، روش playlists.list این خطا را برمی‌گرداند.
    forbidden (403) channelSuspended اگر پارامتر channelId درخواست کانالی را مشخص کند که تعلیق شده است، روش playlists.list این خطا را برمی‌گرداند.
    forbidden (403) playlistForbidden اگر پارامتر id درخواست از درخواست پشتیبانی نکند یا درخواست به‌درستی مجوز نداشته باشد، روش playlists.list این خطا را برمی‌گرداند.
    notFound (404) channelNotFound اگر پارامتر channelId درخواست کانالی را مشخص کند که پیدا نمی‌شود، روش playlists.list این خطا را برمی‌گرداند.
    notFound (404) playlistNotFound اگر پارامتر id درخواست، فهرست پخشی را مشخص کند که پیدا نمی‌شود، روش playlists.list این خطا را برمی‌گرداند.
    notFound (404) videoNotFound اگر پارامتر id درخواست ویدیویی را مشخص کند که پیدا نمی‌شود، روش videos.list این خطا را برمی‌گرداند.
    badRequest (400) invalidRating اگر درخواست حاوی مقدار غیرمنتظره‌ای برای پارامتر rating باشد، روش videos.rate این خطا را برمی‌گرداند.

۲ مارس ۲۰۱۵

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

  • روش search.list اکنون از پارامتر relevanceLanguage پشتیبانی می‌کند که به شما امکان می‌دهد نتایجی را درخواست کنید که بیشترین ارتباط را با زبان خاصی دارند.

    راهنمای انتقال YouTube Data API (v3) نیز به‌روزرسانی شده است تا نحوه استفاده از این پارامتر جدید را توضیح دهد. این پارامتر به شکاف ویژگی‌ای می‌پردازد که قبلاً بین نسخه فعلی API‏ (v3) و نسخه قبلی (v2) وجود داشت که قبلاً منسوخ شده است.

  • راهنمای انتقال YouTube Data API (نسخه ۳) نیز به‌روزرسانی شده است تا نشان دهد که فیدهای ویژه و فیلدهای فراداده که API نسخه ۲ برای توصیف فیلم‌ها، پیش‌پرده‌ها، نمایش‌های تلویزیونی، فصل‌های تلویزیونی، و قسمت‌های تلویزیونی ارائه می‌کرد، منسوخ شده‌اند.

‫۱۴ ژانویه ۲۰۱۵

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

  • راهنمای انتقال YouTube Data API (v3) به‌روزرسانی شده است تا نحوه استفاده از v3 API برای بارگذاری ویدیوها بااستفاده از JavaScript را توضیح دهد. (برای جزئیات بیشتر، به بخش بارگذاری ویدیو مراجعه کنید.) این عملکرد با عملکرد بارگذاری مبتنی بر مرورگر که v2 API پشتیبانی می‌کند قابل‌مقایسه است. توجه داشته باشید که این تغییر در راهنمای انتقال نشان‌دهنده تغییر واقعی API نیست، بلکه نشان‌دهنده دردسترس بودن کد نمونه جدید برای بارگذاری ویدیوها با جاوا اسکریپت سمت مشتری است.

    با توجه به پشتیبانی از بارگذاری ویدیوها با کتابخانه مشتری جاوا اسکریپت و CORS، راهنمای انتقال دیگر بارگذاری مبتنی بر مرورگر را به‌عنوان ویژگی‌ای که ممکن است در API نسخه ۳ منسوخ شود، فهرست نمی‌کند.

  • اسناد مربوط به روش videos.insert به‌روزرسانی شده است تا نمونه کد جدید جاوا اسکریپت که در بالا شرح داده شده است را شامل شود. فهرست نمونه‌های کد JavaScript برای YouTube Data API (نسخه ۳) نیز به‌روز شده است.

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

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

  • هزینه سهمیه برای تماس با روش search.list به ۱۰۰ واحد تغییر کرده است.

    مهم: در بسیاری از موارد، می‌توانید از روش‌های دیگر API برای بازیابی اطلاعات با هزینه سهمیه کمتر استفاده کنید. برای مثال، این دو روش را برای پیدا کردن ویدیوهای بارگذاری‌شده در کانال GoogleDevelopers درنظر بگیرید.

    • هزینه سهمیه: ۱۰۰ واحد

      روش search.list را فراخوانی کنید و GoogleDevelopers را جستجو کنید.

    • هزینه سهمیه: ۶ واحد

      برای پیدا کردن شناسه کانال درست، روش channels.list را فراخوانی کنید. پارامتر forUsername را روی GoogleDevelopers و پارامتر part را روی contentDetails تنظیم کنید. در پاسخ میانای برنامه‌سازی کاربردی، ویژگی contentDetails.relatedPlaylists.uploads شناسه فهرست پخش را برای ویدیوهای بارگذاری‌شده کانال مشخص می‌کند.

      سپس روش playlistItems.list را فراخوانی کنید و پارامتر playlistId را روی شناسه ضبط‌شده و پارامتر part را روی snippet تنظیم کنید.

‫۸ اکتبر ۲۰۱۴

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

  • منبع channel شامل دو ویژگی جدید است:

    • ویژگی status.longUploadsStatus نشان می‌دهد که آیا کانال واجدشرایط بارگذاری ویدیوهای طولانی‌تر از ۱۵ دقیقه است یا نه. این ویژگی فقط درصورتی برگردانده می‌شود که مالک کانال درخواست API را مجاز کرده باشد. مقادیر معتبر خصوصیت عبارت‌اند از:

      • allowed – کانال می‌تواند ویدیوهای طولانی‌تر از ۱۵ دقیقه بارگذاری کند.
      • eligible – کانال واجدشرایط بارگذاری ویدیوهای طولانی‌تر از ۱۵ دقیقه است اما ابتدا باید این ویژگی را فعال کند.
      • disallowed – کانال نمی‌تواند یا واجدشرایط نیست که ویدیوهای طولانی‌تر از ۱۵ دقیقه بارگذاری کند.

      برای اطلاعات بیشتر درباره این مقادیر، تعریف ویژگی را ببینید. مرکز راهنمایی YouTube نیز اطلاعات دقیق‌تری درباره این ویژگی ارائه می‌دهد.

    • ویژگی invideoPromotion.useSmartTiming نشان می‌دهد که آیا کمپین تبلیغاتی کانال از «زمان‌بندی هوشمند» استفاده می‌کند یا خیر. این ویژگی تلاش می‌کند تبلیغات را در نقطه‌ای از ویدیو نشان دهد که احتمال کلیک روی آن‌ها بیشتر و احتمال ایجاد اختلال در تجربه تماشا کمتر باشد. این ویژگی همچنین یک تبلیغ ویژه را برای نمایش در هر ویدیو انتخاب می‌کند.

  • تعاریف ویژگی‌های snippet.title و snippet.categoryId منبع video هر دو به‌روز شده‌اند تا نحوه رسیدگی API به فراخوانی‌های روش videos.update را شفاف‌سازی کنند. اگر آن روش را برای به‌روزرسانی بخش snippet از منبع video فراخوانی کنید، باید برای هر دو ویژگی مقدار تعیین کنید.

    اگر سعی کنید بخش snippet از منبع video را به‌روز کنید و برای هر دو ویژگی مقداری تنظیم نکنید، API خطای invalidRequest را برمی‌گرداند. شرح آن خطا نیز به‌روز شده است.

  • ویژگی contentDetails.contentRating.oflcRating منبع video که رده‌بندی ویدیو را از «اداره طبقه‌بندی فیلم و ادبیات نیوزیلند» شناسایی می‌کند، اکنون از دو رده‌بندی جدید پشتیبانی می‌کند: oflcRp13 و oflcRp16. این‌ها به‌ترتیب با رده‌بندی‌های RP13 و RP16 مطابقت دارند.

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

    نوع خطا جزئیات خطا شرح
    badRequest bannerAlbumFull آلبوم «تصویر انتخابی کانال YouTube» مالک کانال تصاویر زیادی دارد. مالک کانال باید به http://photos.google.com برود، به صفحه آلبوم‌ها پیمایش کند، و برخی‌از تصاویر را از آن آلبوم بردارد.

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

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

  • هزینه سهمیه برای تماس با روش search.list از ۱ واحد به ۲ واحد تغییر کرده است، به‌علاوه هزینه بخش‌های منبع مشخص‌شده.

‫۱۳ اوت ۲۰۱۴

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

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

    نوع خطا جزئیات خطا شرح
    badRequest subscriptionLimitExceeded مشترک شناسایی‌شده با درخواست از حد نرخ اشتراک فراتر رفته است. چند ساعت دیگر می‌توانید برای اشتراک‌های بیشتر تلاش کنید.

‫۱۲ اوت ۲۰۱۴

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

  • راهنمای جدیدی با عنوان انتقال برنامه به YouTube Data API (نسخه ۳) توضیح می‌دهد که چگونه از YouTube Data API (نسخه ۳) برای اجرای عملکردهای موجود در YouTube Data API (نسخه ۲) استفاده کنید. API قدیمی‌تر از ۴ مارس ۲۰۱۴ رسماً منسوخ شده است. این راهنما برای کمک به شما در انتقال برنامه‌هایی که هنوز از API نسخه ۲ استفاده می‌کنند به جدیدترین نسخه API طراحی شده است.

‫۸ ژوئیه ۲۰۱۴

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

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

    نوع خطا جزئیات خطا شرح
    badRequest maxPlaylistExceeded این خطا زمانی رخ می‌دهد که فهرست پخش ایجاد نشود چون کانال درحال‌حاضر حداکثر تعداد فهرست‌های پخش مجاز را دارد.

‫۱۸ ژوئن ۲۰۱۴

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

۲۸ مه ۲۰۱۴

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

  • روش search.list اکنون از پارامترهای location و locationRadius پشتیبانی می‌کند که به شما امکان می‌دهد ویدیوهای مرتبط با یک مکان جغرافیایی را جستجو کنید. درخواست باید مقداری برای هر دو پارامتر مشخص کند تا نتایج براساس مکان بازیابی شود، و اگر درخواست فقط شامل یکی از دو پارامتر باشد، API خطا برمی‌گرداند.

    • پارامتر location مختصات عرض جغرافیایی/طول جغرافیایی را در مرکز منطقه جغرافیایی دایره‌ای مشخص می‌کند.

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

‫۱۳ مه ۲۰۱۴

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

  • ویژگی invideoPromotion.items[] منبع channel به‌روزرسانی شده است تا نشان دهد که معمولاً فقط می‌توانید یک مورد تبلیغ‌شده برای کانالتان تنظیم کنید. اگر سعی کنید موارد تبلیغ‌شده زیادی را درج کنید، API خطای tooManyPromotedItems را برمی‌گرداند که دارای کد وضعیت HTTP 400 است.

  • منبع channelSection اکنون می‌تواند حاوی اطلاعاتی درباره چند نوع جدید از محتوای ویژه باشد. ویژگی snippet.type منبع channelSection اکنون از مقادیر زیر پشتیبانی می‌کند:

    • postedPlaylists - فهرست‌های پخشی که مالک کانال در فید فعالیت کانال پست کرده است
    • postedVideos - ویدیوهایی که مالک کانال در فید فعالیت کانال پست کرده است
    • subscriptions - کانال‌هایی که مالک کانال در آن‌ها مشترک شده است

  • ویژگی جدید contentDetails.contentRating.ifcoRating منبع video رده‌بندی‌ای را که ویدیو از «اداره طبقه‌بندی فیلم ایرلند» دریافت کرده است شناسایی می‌کند.

  • تعریف ویژگی position.cornerPosition منبع watermark به‌روزرسانی شده است تا نشان دهد که ته‌نقش همیشه در گوشه بالا سمت راست پخش‌کننده ظاهر می‌شود.

  • تعریف پارامتر q برای روش search.list به‌روزرسانی شده است تا مشخص شود که عبارت پُرسمان می‌تواند از عملگر بولی NOT (-) برای مستثنی کردن ویدیوهای مرتبط با عبارت جستجوی خاصی استفاده کند. این مقدار همچنین می‌تواند از عملگر بولی OR (|) برای یافتن ویدیوهای مرتبط با یکی از چند عبارت جستجو استفاده کند.

  • تعریف ویژگی pageInfo.totalResults که در پاسخ میانای برنامه‌سازی کاربردی به تماس search.list برگردانده می‌شود به‌روز شده است تا نشان دهد که مقدار تقریبی است و ممکن است مقدار دقیق را نشان ندهد. علاوه‌براین، حداکثر مقدار ۱٬۰۰۰٬۰۰۰ است. نباید از این مقدار برای ایجاد پیوندهای صفحه‌بندی استفاده کنید. به‌جای آن، از مقادیر ویژگی nextPageToken و prevPageToken برای تعیین اینکه آیا پیوندهای صفحه‌بندی نشان داده شوند یا نه استفاده کنید.

  • روش‌های watermarks.set و watermarks.unset به‌روز شده‌اند تا نشان دهند که API برای درخواست‌های موفق به آن روش‌ها، کد پاسخ HTTP 204 را برمی‌گرداند.

۲ مه ۲۰۱۴

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

  • منبع جدید i18nLanguage زبان برنامه‌ای را که وب‌سایت YouTube پشتیبانی می‌کند شناسایی می‌کند. زبان برنامه را می‌توان زبان واسط کاربر نیز نامید. برای وب‌سایت YouTube، زبان برنامه می‌تواند به‌طور خودکار براساس تنظیمات «حساب Google»، زبان مرورگر، یا مکان IP انتخاب شود و کاربر همچنین می‌تواند به‌طور دستی زبان واسط کاربر موردنظر را از پانویس سایت YouTube انتخاب کند.

    این API از روشی برای فهرست کردن زبان‌های پشتیبانی‌شده برنامه پشتیبانی می‌کند. زبان‌های پشتیبانی‌شده را می‌توان به‌عنوان مقدار پارامتر hl هنگام فراخوانی روش‌های API مانند videoCategories.list و guideCategories.list استفاده کرد.

  • منبع جدید i18nRegion منطقه جغرافیایی‌ای را شناسایی می‌کند که کاربر YouTube می‌تواند به‌عنوان منطقه محتوای ترجیحی انتخاب کند. منطقه محتوا را می‌توان به‌عنوان منطقه زبانی محتوا نیز نامید. برای وب‌سایت YouTube، منطقه محتوا می‌تواند به‌طور خودکار براساس روش‌های اکتشافی مانند دامنه YouTube یا مکان IP کاربر انتخاب شود، و کاربر همچنین می‌تواند به‌طور دستی منطقه محتوای موردنظر را از پاورقی سایت YouTube انتخاب کند.

    این میانای برنامه‌سازی کاربردی از روشی برای فهرست کردن مناطق محتوای پشتیبانی‌شده پشتیبانی می‌کند. کدهای منطقه پشتیبانی‌شده را می‌توان به‌عنوان مقدار پارامتر regionCode هنگام فراخوانی روش‌های میانای برنامه‌سازی کاربردی مانند search.list، videos.list، activities.list، و videoCategories.list استفاده کرد.

۷ آوریل ۲۰۱۴

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

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

    این API از روش‌هایی برای فهرست کردن، درج کردن، به‌روزرسانی، یا حذف کردن بخش‌های کانال پشتیبانی می‌کند. می‌توانید با مشخص کردن یک شناسه کانال خاص یا با مشخص کردن فهرستی از شناسه‌های بخش کانال منحصربه‌فرد، فهرستی از بخش‌های کانال را برای کانال کاربر اصالت‌سنجی‌شده بازیابی کنید.

    اسناد خطا نیز به‌روز شده است تا پیام‌های خطایی را که API به‌طور خاص برای این روش‌های جدید پشتیبانی می‌کند شرح دهد.

  • تعریف شیء fileDetails منبع video به‌روزرسانی شده است تا توضیح دهد که آن شیء فقط درصورتی برگردانده می‌شود که ویژگی processingDetails.fileDetailsAvailability ویدیو دارای مقدار available باشد.

    به‌طور مشابه، تعریف شیء suggestions منبع video به‌روزرسانی شده است تا توضیح دهد که این شیء تنها درصورتی بازگردانده می‌شود که ویژگی processingDetails.tagSuggestionsAvailability ویدیو یا ویژگی processingDetails.editorSuggestionsAvailability آن دارای مقدار available باشد.

  • اسناد مربوط به روش‌های videos.insert و videos.update به‌روزرسانی شده است تا نشان دهد که ویژگی status.publishAt را می‌توان هنگام فراخوانی آن روش‌ها تنظیم کرد.

  • تعریف شیء منبع channel invideoPromotion به‌روز شده است تا توضیح دهد که شیء فقط توسط مالک کانال قابل بازیابی است.

  • فهرست پارامتر برای روش videos.rate به‌روز شده است تا نشان دهد که این روش درواقع از پارامتر onBehalfOfContentOwner پشتیبانی نمی‌کند. این یک خطای مستندسازی بود زیرا درخواست‌های videos.rate که این پارامتر را تنظیم می‌کنند، خطای 500 را برمی‌گردانند.

‫۳۱ مارس ۲۰۱۴

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

‫۱۳ مارس ۲۰۱۴

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

  • اکنون میانای برنامه‌سازی کاربردی از بخش contentOwnerDetails برای منابع channel پشتیبانی می‌کند. بخش جدید حاوی داده‌های کانال است که برای شرکای YouTube پیوندشده با کانال مربوط است، ازجمله شناسه مالک محتوای پیوندشده با کانال و تاریخ و زمانی که مالک محتوا و کانال پیوند شده‌اند. توجه داشته باشید که این بخش جدید مشمول خط‌مشی منسوخ کردن نیست.

  • اکنون در اسناد، حداکثر طول نویسه پشتیبانی‌شده برای ویژگی‌های زیر فهرست شده است:

    منبع دارایی حداکثر طول
    channel invideoPromotion.items[].customMessage ‫۴۰ نویسه
    video snippet.title ‫۱۰۰ نویسه
    video snippet.description ‫۵۰۰۰ بایت
    video snippet.tags ۵۰۰ نویسه. توجه داشته باشید که مقدار ویژگی یک فهرست است و کاماهای بین موارد در فهرست در محاسبه حد مجاز لحاظ می‌شوند.

  • خصوصیت brandingSettings.watch.featuredPlaylistId منبع channel منسوخ شده است. اگر بخواهید مقدار آن را تنظیم کنید، میانای برنامه‌سازی کاربردی خطایی برمی‌گرداند.

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

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

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

    نوع خطا جزئیات خطا شرح
    badRequest (400) invalidCriteria اگر درخواست پارامترهای فیلتری را مشخص کند که نمی‌توانند در ارتباط با یکدیگر استفاده شوند، روش channels.list این خطا را برمی‌گرداند.
    badRequest (400) channelTitleUpdateForbidden اگر تلاش کنید بخش brandingSettings کانال را به‌روز کنید و مقدار ویژگی brandingSettings.channel.title را تغییر دهید، روش channels.update این خطا را برمی‌گرداند. (توجه داشته باشید که اگر ویژگی را حذف کنید، API خطا را برنمی‌گرداند.)
    badRequest (400) invalidRecentlyUploadedBy اگر ویژگی invideoPromotion.items[].id.recentlyUploadedBy شناسه کانال نامعتبری را مشخص کند، روش channels.update این خطا را برمی‌گرداند.
    badRequest (400) invalidTimingOffset اگر بخش invideoPromotion یک انحراف زمانی نامعتبر را مشخص کند، روش channels.update این خطا را برمی‌گرداند.
    badRequest (400) tooManyPromotedItems اگر بخش invideoPromotion بیشتر از تعداد مجاز موارد تبلیغ‌شده را مشخص کند، روش channels.update این خطا را برمی‌گرداند.
    forbidden (403) promotedVideoNotAllowed اگر ویژگی invideoPromotion.items[].id.videoId شناسه ویدیویی را مشخص کند که پیدا نمی‌شود یا نمی‌تواند به‌عنوان مورد تبلیغ‌شده استفاده شود، روش channels.update این خطا را برمی‌گرداند.
    forbidden (403) websiteLinkNotAllowed اگر ویژگی invideoPromotion.items[].id.websiteUrl نشانی وبی را مشخص کند که مجاز نیست، روش channels.update این خطا را برمی‌گرداند.
    required (400) requiredTimingType اگر درخواستی تنظیمات زمان‌بندی پیش‌فرض را برای زمانی که YouTube باید مورد تبلیغ‌شده را نمایش دهد مشخص نکند، روش channels.update این خطا را برمی‌گرداند.
    required (400) requiredTiming روش channels.update باید برای هر مورد تبلیغ‌شده یک شیء invideoPromotion.items[].timing مشخص کند.
    required (400) requiredWebsiteUrl روش channels.update باید ویژگی invideoPromotion.items[].id.websiteUrl را برای هر مورد تبلیغ‌شده مشخص کند.
    badRequest (400) invalidPublishAt اگر فراداده درخواست زمان انتشار زمان‌بندی‌شده نامعتبری را مشخص کند، روش videos.insert این خطا را برمی‌گرداند.

۴ مارس ۲۰۱۴

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

۵ دسامبر ۲۰۱۳

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

  • سند روش search.list به‌روزرسانی شده است تا به‌درستی نشان دهد که هنگام ارسال درخواست جستجو، نیازی به تعیین مقدار برای دقیقاً یک پارامتر فیلتر ندارید. بلکه می‌توانید برای صفر پارامتر فیلتر یا برای یک پارامتر فیلتر مقدار تنظیم کنید.

  • تعاریف پارامترهای روش search.list به‌روز شده‌اند تا مشخص شود که اگر مقداری برای هریک از پارامترهای زیر نیز مشخص کنید، باید مقدار پارامتر type را روی video تنظیم کنید:

    • eventType
    • videoCaption
    • videoCategoryId
    • videoDefinition
    • videoDimension
    • videoDuration
    • videoEmbeddable
    • videoLicense
    • videoSyndicated
    • videoType

  • حداقل اندازه تصاویر برنمای کانال بارگذاری‌شده به ۲۰۴۸ پیکسل در ۱۱۵۲ پیکسل کاهش یافته است. (قبلاً حداقل اندازه ۲۱۲۰ پیکسل در ۱۱۹۲ پیکسل بود.) علاوه‌براین، توجه داشته باشید که سند منبع channel حداکثر اندازه همه تصاویر برنما را که از میانای برنامه‌سازی کاربردی ارائه می‌شود مشخص می‌کند. برای مثال، حداکثر اندازه تصویر brandingSettings.image.bannerTvImageUrl برای برنامه‌های تلویزیونی ۲۱۲۰ پیکسل در ۱۱۹۲ پیکسل است، اما تصویر واقعی ممکن است ۲۰۴۸ پیکسل در ۱۱۵۲ پیکسل باشد. مرکز راهنمایی YouTube راهنمایی‌های بیشتری برای بهینه‌سازی طرح کانال برای نمایش در انواع مختلف دستگاه‌ها ارائه می‌دهد.

  • چند تعریف ویژگی منبع channel به‌روزرسانی شده است تا اطلاعات زیر را منعکس کند:

    • حداکثر طول مقدار ویژگی brandingSettings.channel.description ۱۰۰۰ نویسه است.
    • حداکثر طول ویژگی brandingSettings.channel.featuredChannelsTitle ۳۰ نویسه است.
    • دارایی brandingSettings.channel.featuredChannelsUrls[] اکنون می‌تواند تا ۱۰۰ کانال را فهرست کند.
    • مقدار دارایی brandingSettings.channel.unsubscribedTrailer، درصورت تنظیم، باید شناسه ویدیو YouTube یک ویدیو عمومی یا فهرست‌نشده را که متعلق به مالک کانال است مشخص کند.

  • روش channels.update اکنون از به‌روزرسانی‌های ویژگی invideoPromotion.items[].promotedByContentOwner پشتیبانی می‌کند. این ویژگی نشان می‌دهد که آیا نام مالک محتوا هنگام نمایش تبلیغ نشان داده خواهد شد یا نه. این ویژگی فقط زمانی می‌تواند تنظیم شود که درخواست API که مقدار ویژگی را تنظیم می‌کند، ازطرف مالک محتوا و بااستفاده از پارامتر onBehalfOfContentOwner انجام شود.

  • روش‌های playlistItems.list و playlistItems.insert اکنون از پارامتر onBehalfOfContentOwner پشتیبانی می‌کنند که قبلاً برای چندین روش دیگر پشتیبانی می‌شد.

  • ویژگی contentDetails.contentRating.acbRating اکنون می‌تواند رده‌بندی را از «هیئت طبقه‌بندی استرالیا» (ACB) برای فیلم‌ها یا از «مرجع رسانه و ارتباطات استرالیا» (ACMA) برای برنامه‌های تلویزیونی کودکان مشخص کند.

  • ویژگی‌های جدید contentDetails.contentRating.catvRating و contentDetails.contentRating.catvfrRating رده‌بندی‌هایی را که ویدیو تحت «سیستم طبقه‌بندی تلویزیون کانادا» و سیستم رده‌بندی Régie du cinéma به زبان فرانسوی (که در کبک استفاده می‌شود) دریافت کرده است شناسایی می‌کنند.

  • ویژگی جدید snippet.assignable منبع videoCategory نشان می‌دهد که آیا ویدیوهای به‌روزشده یا ویدیوهای تازه‌بارگذاری‌شده می‌توانند با آن دسته ویدیو مرتبط شوند یا نه.

  • نمونه‌های کد برای روش‌های زیر اضافه شده است:

‫۲۴ اکتبر ۲۰۱۳

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

  • این API شامل دو ویژگی اضافی است که برای کمک به یافتن و نمایش محتوای پخش زنده طراحی شده‌اند:

    ویژگی جدید snippet.liveBroadcastContent در نتایج جستجو نشان می‌دهد که آیا منبع ویدیو یا کانال دارای محتوای پخش زنده است یا نه. مقادیر معتبر برای این ویژگی عبارت‌اند از upcoming، active، و none.

    • ویژگی جدید snippet.liveBroadcastContent منبع video نشان می‌دهد که آیا ویدیو یک پخش زنده آتی یا فعال است یا نه. فهرست زیر مقادیر احتمالی این ویژگی را توضیح می‌دهد:

      • upcoming – ویدیو یک پخش زنده است که هنوز شروع نشده است.
      • active – ویدیو یک پخش زنده درحال انجام است.
      • none – ویدیو پخش زنده آتی یا فعال نیست. این مقدار ویژگی برای همه‌فرستی‌های تکمیل‌شده‌ای خواهد بود که هنوز در YouTube قابل‌مشاهده هستند.

    • ویژگی جدید liveStreamingDetails منبع video شیئی است که حاوی فراداده درباره همه‌فرستی ویدیو زنده است. برای بازیابی این فراداده، liveStreamingDetails را در فهرست بخش‌های منبع مقدار پارامتر part قرار دهید. فراداده شامل ویژگی‌های جدید زیر است:

      • liveStreamingDetails.actualStartTime – زمانی که همه‌فرستی واقعاً شروع شد. (این مقدار زمانی وجود خواهد داشت که وضعیت همه‌فرستی active باشد.)
      • liveStreamingDetails.actualEndTime – زمانی که پخش واقعاً پایان یافت. (این مقدار پس‌از پایان همه‌فرستی نشان داده خواهد شد.)
      • liveStreamingDetails.scheduledStartTime – زمانی که همه‌فرستی برای شروع زمان‌بندی شده است.
      • liveStreamingDetails.scheduledEndTime – زمانی که همه‌فرستی برای پایان یافتن زمان‌بندی شده است. اگر مقدار ویژگی خالی باشد یا ویژگی وجود نداشته باشد، همه‌فرستی برای مدت نامحدود زمان‌بندی می‌شود.
      • liveStreamingDetails.concurrentViewers – تعداد افرادی که درحال تماشای پخش زنده هستند.

      برای بازیابی این فراداده، هنگام فراخوانی روش videos.list، videos.insert، یا videos.update، liveStreamingDetails را در مقدار پارامتر part اضافه کنید.

    توجه داشته باشید که دو ویژگی دیگر برای شناسایی محتوای پخش زنده در ۱ اکتبر ۲۰۱۳ منتشر شد – پارامتر eventType روش search.list و ویژگی snippet.liveBroadcastContent نتیجه جستجو.

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

  • فهرست ویژگی‌هایی که می‌توان هنگام فراخوانی روش channels.update اصلاح کرد به‌روز شده است تا ویژگی‌های invideoPromotion.items[].customMessage و invideoPromotion.items[].websiteUrl را دربرگیرد. علاوه‌براین، فهرست اصلاح شده است تا ویژگی‌های brandingSettings که قابل‌اصلاح هستند شناسایی شوند. این brandingSettings ویژگی ازقبل قابل‌تغییر بودند، بنابراین تغییر سند نشان‌دهنده تغییر در عملکرد فعلی API نیست.

  • روش‌های playlists.insert، playlists.update، و playlists.delete اکنون از پارامتر onBehalfOfContentOwner پشتیبانی می‌کنند که قبلاً برای چندین روش دیگر پشتیبانی می‌شد.

  • روش playlists.insert اکنون از پارامتر onBehalfOfContentOwnerChannel پشتیبانی می‌کند که قبلاً برای چندین روش دیگر پشتیبانی می‌شد.

  • ویژگی contentDetails.contentRating.tvpgRating منبع video اکنون از مقدار pg14 پشتیبانی می‌کند که با رده‌بندی TV-14 مطابقت دارد.

  • تعریف ویژگی snippet.liveBroadcastContent، که بخشی از نتایج جستجو است، اصلاح شده است تا نشان دهد live مقدار ویژگی معتبری است، اما active مقدار ویژگی معتبری نیست.

  • ویژگی contentDetails.contentRating.mibacRating منبع video اکنون از دو رده‌بندی دیگر پشتیبانی می‌کند:

    • mibacVap (VAP) – کودکان باید همراه با فردی بزرگسال باشند.
    • mibacVm6 (V.M.6) – محدود به ۶ سال و بالاتر.
    • mibacVm12 (V.M.12) – محدود به ۱۲ سال و بالاتر.

  • ویژگی جدید invideoPromotion.items[].promotedByContentOwner منبع channel نشان می‌دهد که آیا نام مالک محتوا هنگام نمایش تبلیغ نشان داده خواهد شد یا نه. این فیلد فقط درصورتی می‌تواند تنظیم شود که درخواست API که مقدار را تنظیم می‌کند ازطرف مالک محتوا انجام شود. برای اطلاعات بیشتر، پارامتر onBehalfOfContentOwner را ببینید.

۱ اکتبر ۲۰۱۳

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

  • شیء جدید auditDetails منبع channel حاوی داده‌های کانالی است که یک شبکه چندکانالی (MCN) هنگام تصمیم‌گیری برای پذیرش یا رد یک کانال خاص ارزیابی می‌کند. توجه داشته باشید که هر درخواست API که این بخش منبع را بازیابی می‌کند باید یک توکن مجوز ارائه دهد که حاوی دامنه https://www.googleapis.com/auth/youtubepartner-channel-audit باشد. علاوه‌براین، هر نشانه‌ای که از آن دامنه استفاده می‌کند باید زمانی که MCN تصمیم به پذیرش یا رد کانال می‌گیرد یا ظرف دو هفته از تاریخ صدور نشانه، لغو شود.

  • ویژگی invideoPromotion.items[].id.type منبع channel اکنون از مقدار recentUpload پشتیبانی می‌کند که نشان می‌دهد مورد تبلیغ‌شده جدیدترین ویدیو بارگذاری‌شده از کانال مشخص‌شده است.

    به‌طور پیش‌فرض، کانال همان کانالی است که داده‌های تبلیغ درون‌ویدیویی برای آن تنظیم شده است. بااین‌حال، می‌توانید با تنظیم مقدار ویژگی جدید invideoPromotion.items[].id.recentlyUploadedBy روی شناسه کانال موردنظر، جدیدترین ویدیو بارگذاری‌شده از کانال دیگری را تبلیغ کنید.

  • منبع channel حاوی سه ویژگی جدید است – brandingSettings.image.bannerTvLowImageUrl، brandingSettings.image.bannerTvMediumImageUrl، brandingSettings.image.bannerTvHighImageUrl – که نشانی‌های وب تصاویر برنما را که در صفحات کانال در برنامه‌های تلویزیونی نمایش داده می‌شوند، مشخص می‌کنند.

  • ویژگی جدید snippet.liveBroadcastContent در نتایج جستجو نشان می‌دهد که آیا منبع ویدیو یا کانال دارای محتوای پخش زنده است یا نه. مقادیر معتبر برای این ویژگی عبارت‌اند از upcoming، active، و none.

    • برای منبع video، مقدار upcoming نشان می‌دهد که ویدیو یک پخش زنده است که هنوز شروع نشده است، درحالی‌که مقدار active نشان می‌دهد که ویدیو یک پخش زنده درحال انجام است.
    • برای منبع channel، مقدار upcoming نشان می‌دهد که کانال همه‌فرستی زمان‌بندی‌شده‌ای دارد که هنوز شروع نشده است، درحالی‌که مقدار acive نشان می‌دهد که کانال همه‌فرستی زنده درحال انجام دارد.

  • در منبع watermark، ویژگی targetChannelId از شیء به رشته تغییر کرده است. به‌جای داشتن ویژگی فرزند که شناسه کانال YouTube کانالی را که تصویر ته‌نقش به آن پیوند می‌دهد مشخص می‌کند، ویژگی targetChannelId اکنون خود آن مقدار را مشخص می‌کند. بنابراین، ویژگی targetChannelId.value منبع برداشته شده است.

  • روش thumbnails.set اکنون از پارامتر onBehalfOfContentOwner پشتیبانی می‌کند که قبلاً برای چندین روش دیگر پشتیبانی می‌شد.

  • روش search.list اکنون از پارامتر eventType پشتیبانی می‌کند که جستجو را محدود می‌کند تا فقط رویدادهای همه‌فرستی فعال، آتی، یا تکمیل‌شده را برگرداند.

  • مشخصه جدید contentDetails.contentRating.mibacRating رده‌بندی‌ای را که ویدیو از Ministero dei Beni e delle Attivita Culturali e del Turismo ایتالیا دریافت کرده است شناسایی می‌کند.

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

    نوع خطا جزئیات خطا شرح
    badRequest invalidImage اگر محتوای تصویر ارائه‌شده نامعتبر باشد، روش thumbnails.set این خطا را برمی‌گرداند.
    forbidden videoRatingDisabled اگر مالک ویدیویی که رتبه‌بندی می‌شود رتبه‌بندی را برای آن ویدیو غیرفعال کرده باشد، روش videos.rate این خطا را برمی‌گرداند.

‫۲۷ اوت ۲۰۱۳

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

  • منبع جدید watermark تصویری را شناسایی می‌کند که درطول بازپخش ویدیوهای کانال مشخص‌شده نمایش داده می‌شود. همچنین می‌توانید کانال هدفی را مشخص کنید که تصویر به آن پیوند داده می‌شود و همچنین جزئیات زمان‌بندی که تعیین می‌کند ته‌نقش چه زمانی درطول بازپخش ویدیو ظاهر شود و مدت زمانی که قابل‌مشاهده است.

    روش watermarks.set تصویر ته‌نقش کانال را بارگذاری و تنظیم می‌کند. روش watermarks.unset تصویر ته‌نقش کانال را حذف می‌کند.

    اسناد خطا پیام‌های خطایی را که API به‌طور خاص برای روش‌های watermarks.set و watermarks.unset پشتیبانی می‌کند شرح می‌دهد.

  • ویژگی جدید statistics.hiddenSubscriberCount منبع channel حاوی یک مقدار بولی است که نشان می‌دهد آیا تعداد مشترکین کانال پنهان است یا خیر. بنابراین، اگر تعداد مشترکان کانال به‌صورت عمومی قابل‌مشاهده باشد، مقدار این ویژگی false است.

  • روش playlists.list اکنون از پارامترهای onBehalfOfContentOwner و onBehalfOfContentOwnerChannel پشتیبانی می‌کند. هر دو پارامتر ازقبل برای چندین روش دیگر پشتیبانی می‌شوند.

  • روش videos.list اکنون از پارامتر regionCode پشتیبانی می‌کند که منطقه محتوایی را که نمودار باید برای آن بازیابی شود شناسایی می‌کند. این پارامتر فقط در ترکیب با پارامتر chart قابل‌استفاده است. مقدار پارامتر کد کشور ISO 3166-1 alpha-2 است.

  • error documentation خطای درخواست رایج جدید زیر را شرح می‌دهد که ممکن است برای چندین روش میانای برنامه‌سازی کاربردی رخ دهد:

    نوع خطا جزئیات خطا شرح
    forbidden insufficientPermissions دامنه‌های مرتبط با کد OAuth 2.0 ارائه‌شده برای درخواست، برای دسترسی به داده‌های درخواستی کافی نیستند.

‫۱۵ اوت ۲۰۱۳

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

  • شیء invideoPromotion منبع channel دارای ویژگی‌های جدید و به‌روزشده زیر است:

    • این میانای برنامه‌سازی کاربردی اکنون از قابلیت مشخص کردن وب‌سایت به‌عنوان مورد تبلیغ‌شده پشتیبانی می‌کند. برای انجام این کار، مقدار ویژگی invideoPromotion.items[].id.type را روی website تنظیم کنید و از ویژگی جدید invideoPromotion.items[].id.websiteUrl برای مشخص کردن نشانی وب استفاده کنید. همچنین از ویژگی جدید invideoPromotion.items[].customMessage برای تعریف پیام سفارشی برای نمایش در عرضه ترویجی استفاده کنید.

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

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

    • ویژگی‌های مربوط به تنظیمات زمان‌بندی برای نمایش موارد تبلیغ‌شده درطول بازپخش ویدیو بازسازی شده‌اند:

      • شیء invideoPromotion.timing به invideoPromotion.items[].timing منتقل شده است. این شیء اکنون به شما امکان می‌دهد داده‌های زمان‌بندی را برای هر مورد تبلیغ‌شده در فهرست invideoPromotion.items[] سفارشی‌سازی کنید.

      • شیء جدید invideoPromotion.defaultTiming تنظیمات زمان‌بندی پیش‌فرض را برای تبلیغ شما مشخص می‌کند. این تنظیمات مشخص می‌کنند که چه زمانی یک مورد تبلیغ‌شده درطول بازپخش یکی از ویدیوهای کانال شما نمایش داده شود. بااستفاده از شیء invideoPromotion.items[].timing می‌توانید زمان‌بندی پیش‌فرض را برای هر مورد تبلیغ‌شده‌ای لغو کنید.

      • ویژگی جدید invideoPromotion.items[].timing.durationMs مقدار زمان نمایش تبلیغ ویژه را به میلی‌ثانیه مشخص می‌کند. شیء invideoPromotion.defaultTiming همچنین حاوی فیلد durationMs است که مدت زمان پیش‌فرض نمایش مورد تبلیغ‌شده را مشخص می‌کند.

    • هر دو ویژگی invideoPromotion.items[].type و invideoPromotion.items[].videoId به شیء invideoPromotion.items[].id منتقل شده‌اند.

  • روش subscriptions.list اکنون از پارامترهای onBehalfOfContentOwner و onBehalfOfContentOwnerChannel پشتیبانی می‌کند. هر دو پارامتر ازقبل برای چندین روش دیگر پشتیبانی می‌شوند.

  • در پاسخ میانای برنامه‌سازی کاربردی به درخواست thumbnails.set، مقدار ویژگی kind از youtube#thumbnailListResponse به youtube#thumbnailSetResponse تغییر کرده است.

  • نمونه‌های کد برای روش‌های زیر اضافه شده است:

    توجه داشته باشید که نمونه Python برای روش playlistItems.insert نیز برداشته شده است زیرا عملکردی که نشان می‌داد اکنون توسط روش videos.rate انجام می‌شود.

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

    نوع خطا جزئیات خطا شرح
    badRequest invalidMine پارامتر mine را نمی‌توان در درخواست‌هایی استفاده کرد که کاربر اصالت‌سنجی‌شده شریک YouTube است. باید پارامتر mine را بردارید، با برداشتن پارامتر onBehalfOfContentOwner به‌عنوان کاربر YouTube اصالت‌سنجی کنید، یا با ارائه پارامتر onBehalfOfContentOwnerChannel (درصورت دردسترس بودن برای روش فراخوانی‌شده) به‌عنوان یکی از کانال‌های شریک عمل کنید.

‫۸ اوت ۲۰۱۳

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

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

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

  • در منبع channelBanner، مقدار ویژگی kind از youtube#channelBannerInsertResponse به youtube#channelBannerResource تغییر کرده است. این منبع در پاسخ به درخواست channelBanners.insert برگردانده می‌شود.

  • ویژگی جدید brandingSettings.channel.profileColor منبع channel رنگ برجسته‌ای را مشخص می‌کند که مکمل محتوای کانال است. مقدار ویژگی یک علامت پوند (#) است که به‌دنبال آن یک رشته شانزده‌شانزدهی شش نویسه‌ای، مانند #2793e6، می‌آید.

  • اکنون API از این قابلیت پشتیبانی می‌کند که مشخص شود آیا اشتراک برای همه فعالیت‌های یک کانال است یا فقط برای بارگذاری‌های جدید. ویژگی جدید contentDetails.activityType منبع subscription انواع فعالیت‌هایی را که مشترک درباره آن‌ها مطلع خواهد شد شناسایی می‌کند. مقادیر دارایی معتبر all و uploads است.

  • روش videos.list از پارامترهای جدیدی برای بازیابی نمودار محبوب‌ترین ویدیوها در YouTube پشتیبانی می‌کند:

    • پارامتر chart نموداری را که می‌خواهید بازیابی کنید شناسایی می‌کند. درحال‌حاضر، تنها مقدار پشتیبانی‌شده mostPopular است. توجه داشته باشید که پارامتر chart یک پارامتر فیلتر است، به این معنی که نمی‌توان از آن در همان درخواست پارامترهای فیلتر دیگر (id و myRating) استفاده کرد.
    • پارامتر videoCategoryId دسته ویدیو را که نمودار باید برای آن بازیابی شود شناسایی می‌کند. این پارامتر فقط در ترکیب با پارامتر chart قابل‌استفاده است. به‌طور پیش‌فرض، نمودارها به دسته خاصی محدود نمی‌شوند.

  • ویژگی جدید topicDetails.relevantTopicIds[] منبع video فهرستی از شناسه‌های موضوع Freebase را ارائه می‌دهد که به ویدیو یا محتوای آن مربوط هستند. موضوعات این مباحث ممکن است در ویدیو ذکر شوند یا ظاهر شوند.

  • نام ویژگی recordingDetails.location.elevation از منبع video به recordingDetails.location.altitude تغییر کرده است و نام ویژگی fileDetails.recordingLocation.location.elevation آن به fileDetails.recordingLocation.location.altitude تغییر کرده است.

  • شیء contentDetails.contentRating منبع video رده‌بندی‌هایی را که ویدیو تحت طرح‌های رده‌بندی مختلف دریافت کرده است، ازجمله رده‌بندی‌های MPAA، رده‌بندی‌های TVPG و غیره، مشخص می‌کند. برای هر سیستم رده‌بندی، API اکنون از یک مقدار رده‌بندی پشتیبانی می‌کند که نشان می‌دهد ویدیو رده‌بندی نشده است. توجه داشته باشید که برای رده‌بندی‌های MPAA، رده‌بندی «unrated» (بدون رده‌بندی) اغلب برای شناسایی نسخه‌های سانسورنشده فیلم‌هایی استفاده می‌شود که نسخه سانسورشده آن‌ها رده‌بندی رسمی دریافت کرده است.

  • ویژگی جدید contentDetails.contentRating.ytRating منبع video محتوای دارای محدودیت سنی را شناسایی می‌کند. اگر YouTube تشخیص دهد که ویدیو حاوی محتوای نامناسب برای کاربران زیر ۱۸ سال است، مقدار ویژگی ytAgeRestricted خواهد بود. اگر این ویژگی وجود نداشته باشد یا مقدار آن خالی باشد، محتوا به‌عنوان دارای محدودیت سنی شناسایی نشده است.

  • پارامتر mySubscribers روش channels.list منسوخ شده است. از روش subscriptions.list و پارامتر mySubscribers آن برای بازیابی فهرست مشترکین کانال کاربر اصالت‌سنجی‌شده استفاده کنید.

  • روش‌های channelBanners.insert، channels.update، videos.getRating، و videos.rate اکنون همگی از پارامتر onBehalfOfContentOwner پشتیبانی می‌کنند. این پارامتر نشان می‌دهد که کاربر اصالت‌سنجی‌شده ازطرف مالک محتوای مشخص‌شده در مقدار پارامتر عمل می‌کند.

  • سند روش channels.update به‌روز شده است تا نشان دهد که از این روش می‌توان برای به‌روزرسانی شیء brandingSettings منبع channel و ویژگی‌های فرزند آن استفاده کرد. اکنون در اسناد، فهرست به‌روزشده ویژگی‌هایی که می‌توانید برای شیء invideoPromotion منبع channel تنظیم کنید نیز فهرست شده است.

  • error documentation خطاهای جدید زیر را شرح می‌دهد:

    نوع خطا جزئیات خطا شرح
    forbidden accountDelegationForbidden این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. این خطا نشان می‌دهد که کاربر اصالت‌سنجی‌شده مجاز نیست ازطرف حساب Google مشخص‌شده اقدام کند.
    forbidden authenticatedUserAccountClosed این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. این خطا نشان می‌دهد که حساب YouTube کاربر اصالت‌سنجی‌شده بسته شده است. اگر کاربر ازطرف «حساب Google» دیگری اقدام می‌کند، این خطا نشان می‌دهد که آن حساب دیگر بسته شده است.
    forbidden authenticatedUserAccountSuspended این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. این خطا نشان می‌دهد که حساب YouTube کاربر اصالت‌سنجی‌شده تعلیق شده است. اگر کاربر ازطرف «حساب Google» دیگری اقدام می‌کند، این خطا نشان می‌دهد که آن حساب دیگر تعلیق شده است.
    forbidden authenticatedUserNotChannel این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. این خطا نشان می‌دهد که سرور میانای برنامه‌سازی کاربردی نمی‌تواند کانال مرتبط با درخواست میانای برنامه‌سازی کاربردی را شناسایی کند. اگر درخواست مجاز باشد و از پارامتر onBehalfOfContentOwner استفاده کند، باید پارامتر onBehalfOfContentOwnerChannel را نیز تنظیم کنید.
    forbidden cmsUserAccountNotFound این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. کاربر «سیستم مدیریت محتوا» مجاز نیست ازطرف مالک محتوای مشخص‌شده اقدام کند.
    notFound contentOwnerAccountNotFound این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. حساب مالک محتوای مشخص‌شده پیدا نشد.
    badRequest invalidPart این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. پارامتر part درخواست بخش‌هایی را مشخص می‌کند که نمی‌توانند هم‌زمان نوشته شوند.
    badRequest videoChartNotFound وقتی درخواست نمودار ویدیویی پشتیبانی‌نشده یا غیرقابل‌دسترس را مشخص می‌کند، روش videos.list این خطا را برمی‌گرداند.
    notFound videoNotFound روش videos.update این خطا را برمی‌گرداند تا نشان دهد ویدیویی که می‌خواهید به‌روز کنید پیدا نمی‌شود. مقدار ویژگی id را در بدنه درخواست بررسی کنید تا مطمئن شوید درست است.

‫۱۰ ژوئن ۲۰۱۳

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

  • پارامتر جدید forUsername در روش channels.list به شما امکان می‌دهد با مشخص کردن نام کاربری YouTube یک کانال، اطلاعات مربوط به آن را بازیابی کنید.

  • روش activities.list اکنون از پارامتر regionCode پشتیبانی می‌کند که به میانای برنامه‌سازی کاربردی دستور می‌دهد نتایج مربوط به کشور مشخص‌شده را برگرداند. YouTube از این مقدار زمانی استفاده می‌کند که فعالیت قبلی کاربر مجاز در YouTube اطلاعات کافی برای تولید فید فعالیت ارائه نمی‌دهد.

  • منابع فهرست پخش اکنون حاوی ویژگی snippet.tags هستند. این ویژگی فقط به کاربران مجاز که درحال بازیابی داده‌های مربوط به فهرست‌های پخش خود هستند برگردانده می‌شود. کاربران مجاز همچنین می‌توانند هنگام فراخوانی روش‌های playlists.insert یا playlists.update، برچسب‌های فهرست پخش را تنظیم کنند.

  • پارامتر onBehalfOfContentOwner که قبلاً برای روش‌های channels.list و search.list پشتیبانی می‌شد، اکنون برای روش‌های videos.insert، videos.update، و videos.delete نیز پشتیبانی می‌شود. توجه داشته باشید که وقتی از این پارامتر در فراخوانی روش videos.insert استفاده می‌شود، درخواست باید مقداری را نیز برای پارامتر جدید onBehalfOfContentOwnerChannel مشخص کند که کانالی را که ویدیو به آن اضافه خواهد شد شناسایی می‌کند. کانال باید به مالک محتوایی که پارامتر onBehalfOfContentOwner مشخص می‌کند پیوند داده شود.

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

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

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

  • error documentation خطاهای جدید زیر را شرح می‌دهد:

    نوع خطا جزئیات خطا شرح
    forbidden insufficientCapabilities این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. این خطا نشان می‌دهد که کاربر CMS که API را فراخوانی می‌کند، مجوزهای کافی برای انجام عملیات درخواستی را ندارد. این خطا با استفاده از پارامتر onBehalfOfContentOwner مرتبط است که برای چندین روش میانای برنامه‌سازی کاربردی پشتیبانی می‌شود.
    unauthorized authorizationRequired وقتی درخواست از پارامتر home استفاده می‌کند اما به‌درستی مجوز ندارد، روش activities.list این خطا را برمی‌گرداند.

  • در منبع channels، ویژگی invideoPromotion.channelId برداشته شده است زیرا شناسه کانال قبلاً بااستفاده از ویژگی id منبع مشخص شده است.

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

‫۲۲ مه ۲۰۱۳

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

  • روش جدید channelBanners.insert به شما امکان می‌دهد تصویر برنمایی را بارگذاری کنید که بعداً می‌تواند بااستفاده از ویژگی جدید brandingSettings.image.bannerExternalUrl منبع channel به‌عنوان تصویر برنما برای کانال تنظیم شود.

  • اسناد مربوط به روش channels.update به‌روزرسانی شده است تا ویژگی‌هایی را که می‌توان هنگام فراخوانی روش اصلاح کرد فهرست کند.

  • video اسناد منبع دیگر unspecified را به‌عنوان مقدار خصوصیت معتبر برای خصوصیات suggestions.processingErrors[]، suggestions.processingHints[]، suggestions.processingWarnings[]، و suggestions.editorSuggestions[] فهرست نمی‌کند.

  • پارامتر maxResults روش videos.list اکنون مقدار پیش‌فرض 5 دارد.

  • error documentation اکنون خطاهای روش‌های channelBanners.insert و subscriptions.list را فهرست می‌کند. همچنین چندین خطای جدید برای روش channels.update فهرست می‌کند.

‫۱۴ مه ۲۰۱۳

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

  • صفحه‌های مستقل اکنون نمونه‌های کد را برای Java،‏ .NET،‏ PHP، و Ruby فهرست می‌کنند.

  • صفحه‌ای که نمونه کدهای Python را فهرست می‌کند اکنون شامل نمونه‌هایی برای افزودن اشتراک، ایجاد فهرست پخش، و به‌روزرسانی ویدیو است.

‫۱۰ مه ۲۰۱۳

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

۸ مه ۲۰۱۳

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

  • منابع کانال اکنون از شیء inVideoPromotion پشتیبانی می‌کنند که اطلاعات مربوط به پویش تبلیغاتی مرتبط با کانال را دربرمی‌گیرد. یک کانال می‌تواند از یک پویش تبلیغاتی درون ویدیویی برای نمایش تصاویر کوچک برای یک ویدیو تبلیغ‌شده در پخش‌کننده ویدیو درطول بازپخش ویدیوهای کانال استفاده کند.

    می‌توانید این داده‌ها را با گنجاندن invideoPromotion در مقدار پارامتر part در درخواست channels.list بازیابی کنید.

  • از روش جدید channels.update می‌توان برای به‌روزرسانی داده‌های پویش تبلیغاتی درون‌ویدیویی کانال استفاده کرد. توجه داشته باشید که این روش فقط از به‌روزرسانی‌های بخش invideoPromotion منبع channel پشتیبانی می‌کند و هنوز از به‌روزرسانی‌های بخش‌های دیگر آن منبع پشتیبانی نمی‌کند.

۲ مه ۲۰۱۳

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

  • منابع کانال اکنون از ویژگی status.isLinked پشتیبانی می‌کنند که نشان می‌دهد آیا داده‌های کانال کاربری را شناسایی می‌کند که قبلاً به نام کاربری YouTube یا حساب Google+‎ پیوند شده است یا نه. کاربری که یکی از این پیوندها را دارد، قبلاً یک هویت عمومی YouTube داشته است که پیش‌نیاز چندین اقدام مانند بارگذاری ویدیوها است.

  • منابع اشتراک اکنون از بخش subscriberSnippet پشتیبانی می‌کنند. آن شیء حاوی داده‌های قطعه برای کانال مشترک است.

  • اکنون API از روش videos.getRating پشتیبانی می‌کند که رده‌بندی‌هایی را که کاربر اصالت‌سنجی‌شده به فهرستی از یک یا چند ویدیو داده است بازیابی می‌کند.

  • پارامتر جدید myRating در روش videos.list به شما امکان می‌دهد فهرستی از ویدیوهایی را که کاربر اصالت‌سنجی‌شده با رده‌بندی like یا dislike رده‌بندی کرده است بازیابی کنید.

    پارامتر myRating و پارامتر id اکنون هر دو به‌عنوان پارامترهای فیلتر درنظر گرفته می‌شوند، به این معنی که درخواست API باید دقیقاً یکی از این پارامترها را مشخص کند. (قبلاً، پارامتر id پارامتری الزامی برای این روش بود.)

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

  • با معرفی پارامتر myRating، روش videos.list نیز برای پشتیبانی از صفحه‌بندی به‌روز شده است. بااین‌حال، توجه داشته باشید که پارامترهای صفحه‌بندی فقط برای درخواست‌هایی که از پارامتر myRating استفاده می‌کنند پشتیبانی می‌شود. (پارامترها و اطلاعات صفحه‌بندی برای درخواست‌هایی که از پارامتر id استفاده می‌کنند پشتیبانی نمی‌شود.)

    • پارامتر maxResults حداکثر تعداد ویدیوهایی را که میانای برنامه‌سازی کاربردی می‌تواند در مجموعه نتایج برگرداند مشخص می‌کند و پارامتر pageToken صفحه خاصی را در مجموعه نتایج که می‌خواهید بازیابی کنید شناسایی می‌کند.

    • منبع youtube#videoListResponse که در پاسخ به درخواست videos.list برگردانده می‌شود، اکنون حاوی شیء pageInfo است که جزئیاتی مانند تعداد کل نتایج و تعداد نتایج موجود در مجموعه نتایج فعلی را دربرمی‌گیرد. منبع youtube#videoListResponse همچنین می‌تواند شامل ویژگی‌های nextPageToken و prevPageToken باشد که هرکدام نشانه‌ای ارائه می‌دهند که می‌تواند برای بازیابی صفحه خاصی در مجموعه نتایج استفاده شود.

  • روش videos.insert از پارامترهای جدید زیر پشتیبانی می‌کند:

    • autoLevels – مقدار این پارامتر را روی true تنظیم کنید تا به YouTube دستور دهید نور و رنگ ویدیو را به‌طور خودکار بهبود دهد.
    • stabilize – مقدار این پارامتر را روی true تنظیم کنید تا به YouTube دستور دهید ویدیو را با حذف لرزش ناشی از حرکات دوربین تنظیم کند.

  • ویژگی channelTitle به snippet برای منابع زیر اضافه شده است:

    • playlistItem – این ویژگی نام کانالی را که مورد فهرست پخش را اضافه کرده است مشخص می‌کند.
    • playlist – این ویژگی نام کانالی را که فهرست پخش را ایجاد کرده است مشخص می‌کند.
    • subscription – این ویژگی نام کانالی را که در آن مشترک شده‌اید مشخص می‌کند.

  • نمونه‌های کد برای روش‌های زیر اضافه شده است:

  • پارامتر جدید mySubscribers در روش subscriptions.list به شما امکان می‌دهد فهرستی از مشترکین کاربر اصالت‌سنجی‌شده فعلی را بازیابی کنید. از این پارامتر فقط می‌توان در درخواست‌های دارای مجوز مناسب استفاده کرد.

    توجه: این عملکرد برای جایگزینی پارامتر mySubscribers که درحال‌حاضر برای روش channels.list پشتیبانی می‌شود درنظر گرفته شده است. آن پارامتر منسوخ خواهد شد.

  • در منبع video، مقدار ویژگی unspecified دیگر مقدار احتمالی برای هیچ‌یک از ویژگی‌های زیر نیست:

  • درخواست‌های API که حاوی پارامتر غیرمنتظره هستند اکنون خطای badRequest را برمی‌گردانند و دلیل گزارش‌شده برای خطا unexpectedParameter است.

  • خطایی که روش playlistItems.insert وقتی فهرست پخش ازقبل حاوی حداکثر تعداد مجاز موارد است برمی‌گرداند به‌روز شده است. اکنون این خطا به‌عنوان خطای forbidden گزارش می‌شود و دلیل خطا playlistContainsMaximumNumberOfVideos است.

‫۱۹ آوریل ۲۰۱۳

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

  • روش جدید videos.rate به کاربر اجازه می‌دهد تا رده‌بندی like یا dislike را برای ویدیو تنظیم کند یا رده‌بندی را از ویدیو بردارد.

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

  • تصاویر ریزعکس اکنون در اسناد API به‌عنوان یک منبع جداگانه شناسایی می‌شوند و روش جدید thumbnails.set به شما امکان می‌دهد یک ریزعکس ویدیو سفارشی را در YouTube بارگذاری کنید و آن را برای یک ویدیو تنظیم کنید.

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

    توجه داشته باشید که این تغییر واقعاً بر منابع موجود که تصاویر ریزعکس را برمی‌گردانند تأثیری ندارد. تصاویر کوچک در آن منابع به همان روشی که قبلاً بودند برگردانده می‌شوند، اگرچه اسناد اکنون نام اندازه‌های مختلف تصویر کوچک را که API ممکن است برگرداند فهرست می‌کند.

  • بخش جدید brandingSettings منبع channel تنظیمات، نوشتار، و تصاویر صفحه کانال و صفحات تماشای ویدیو کانال را شناسایی می‌کند.

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

    • شیء جدید status اطلاعات وضعیت مربوط به مورد فهرست پخش را کپسوله می‌کند و ویژگی status.privacyStatus وضعیت حریم خصوصی مورد فهرست پخش را شناسایی می‌کند.

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

  • اسناد روش playlistItems.update به‌روزرسانی شده است تا نشان دهد که ویژگی snippet.resourceId باید در منبع ارسال‌شده به‌عنوان بدنه درخواست مشخص شود.

  • روش search.list اکنون از عملکرد زیر پشتیبانی می‌کند:

    • پارامتر جدید forMine جستجو را محدود می‌کند تا فقط ویدیوهای کاربر اصالت‌سنجی‌شده را بازیابی کند.

    • پارامتر order اکنون از قابلیت مرتب‌سازی نتایج به‌ترتیب حروف الفبا براساس عنوان (order=title) یا براساس تعداد ویدیو به‌ترتیب نزولی (order=videoCount) پشتیبانی می‌کند.

    • پارامتر جدید safeSearch نشان می‌دهد که آیا نتایج جستجو باید شامل محتوای محدودشده باشد یا نه.

  • روش videos.insert از چندین خطای جدید پشتیبانی می‌کند که در جدول زیر فهرست شده‌اند:

    نوع خطا جزئیات خطا شرح
    badRequest invalidCategoryId ویژگی snippet.categoryId شناسه دسته نامعتبری را مشخص می‌کند. از روش videoCategories.list برای بازیابی دسته‌های پشتیبانی‌شده استفاده کنید.
    badRequest invalidRecordingDetails metadata جزئیات ضبط نامعتبری را مشخص می‌کند.
    badRequest invalidVideoGameRating فراداده درخواست، رده‌بندی نامعتبر بازی ویدیویی را مشخص می‌کند.
    badRequest invalidVideoMetadata فراداده درخواست نامعتبر است.

  • پارامتر onBehalfOfContentOwner از فهرست پارامترهای پشتیبانی‌شده برای روش‌های videos.update و videos.delete برداشته شده است.

۱۲ مارس ۲۰۱۳

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

  • ویژگی channelTitle به snippet برای منابع زیر اضافه شده است:

    • activity – این ویژگی نام کانال مسئول فعالیت را مشخص می‌کند.
    • search – این ویژگی نام کانال مرتبط با منبعی را که نتیجه جستجو شناسایی می‌کند مشخص می‌کند.
    • video – این ویژگی نام کانالی را که ویدیو را بارگذاری کرده است مشخص می‌کند.

  • روش search.list از پارامترهای جدید زیر پشتیبانی می‌کند:

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

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

  • تعریف بخش recordingDetails از منبع video به‌روزرسانی شده است تا مشخص شود که شیء فقط درصورتی برای ویدیو برگردانده می‌شود که داده‌های موقعیت جغرافیایی یا زمان ضبط ویدیو تنظیم شده باشد.

  • روش playlistItems.update اکنون خطای invalidSnippet را برمی‌گرداند که درصورت عدم تعیین قطعه معتبر در درخواست API برگردانده می‌شود.

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

    • پارامتر onBehalfOfContentOwner نشان می‌دهد که اطلاعات اعتباری مجوز درخواست، کاربر YouTube CMS را که ازطرف مالک محتوای مشخص‌شده در مقدار پارامتر اقدام می‌کند شناسایی می‌کند. حساب CMS که کاربر با آن اصالت‌سنجی می‌کند باید به مالک محتوای YouTube مشخص‌شده پیوند داده شده باشد.

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

      روش‌های channels.list، search.list، videos.delete، videos.list، و videos.update همگی از این پارامتر پشتیبانی می‌کنند.

    • پارامتر managedByMe که توسط روش channels.list پشتیبانی می‌شود، به API دستور می‌دهد تا همه کانال‌های متعلق به مالک محتوا را که پارامتر onBehalfOfContentOwner مشخص می‌کند، برگرداند.

    • پارامتر forContentOwner که توسط روش search.list پشتیبانی می‌شود، به API دستور می‌دهد تا نتایج جستجو را محدود کند تا فقط شامل منابعی باشد که متعلق به مالک محتوایی است که پارامتر onBehalfOfContentOwner مشخص می‌کند.

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

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

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

    • بخش‌های جدید fileDetails، processingDetails، و suggestions اطلاعاتی درباره ویدیوهای بارگذاری‌شده به مالکان ویدیو ارائه می‌دهند. این داده‌ها در برنامه‌هایی که بارگذاری ویدیو را فعال می‌کنند بسیار مفید هستند و شامل موارد زیر می‌شوند:

      • وضعیت پردازش و پیشرفت
      • خطاها یا مشکلات دیگری که هنگام پردازش ویدیو رخ داده است
      • دردسترس بودن تصاویر ریزعکس
      • پیشنهادهایی برای بهبود کیفیت ویدیو یا فراداده
      • جزئیات مربوط به فایل اصلی بارگذاری‌شده در YouTube

      همه این بخش‌ها فقط توسط مالک ویدیو قابل بازیابی است. فهرست زیر به‌طور خلاصه بخش‌های جدید را شرح می‌دهد و سند منبع video همه ویژگی‌هایی را که هر بخش دارد تعریف می‌کند.

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

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

        این شیء برای نظرسنجی طراحی شده است تا بارگذارنده ویدیو بتواند پیشرفتی را که YouTube در پردازش فایل ویدیویی بارگذاری‌شده داشته است، پیگیری کند.

      • شیء suggestions حاوی پیشنهادهایی است که فرصت‌های بهبود کیفیت ویدیو یا فراداده ویدیو بارگذاری‌شده را شناسایی می‌کند.

    • بخش contentDetails شامل چهار ویژگی جدید است. این ویژگی‌ها را می‌توان با درخواست‌های تأییدنشده بازیابی کرد.

      • dimension – نشان می‌دهد که ویدیو به‌صورت دوبعدی یا سه‌بعدی دردسترس است یا نه.
      • definition – نشان می‌دهد که ویدیو با وضوح استاندارد یا بالا دردسترس است یا نه.
      • caption – نشان می‌دهد که آیا زیرنویس ناشنوایان برای ویدیو دردسترس است یا نه.
      • licensedContent – نشان می‌دهد که آیا ویدیو حاوی محتوایی است که توسط شریک محتوای YouTube ادعای مالکیت شده است یا خیر.

    • بخش status شامل دو ویژگی جدید است. مالکان ویدیو می‌توانند هنگام درج یا به‌روزرسانی ویدیو، مقادیری را برای هر دو ویژگی تنظیم کنند. این ویژگی‌ها را می‌توان با درخواست‌های تأییدنشده نیز بازیابی کرد.

      • embeddable – نشان می‌دهد که آیا ویدیو می‌تواند در وب‌سایت دیگری جاسازی شود یا نه.
      • license – پروانه ویدیو را مشخص می‌کند. مقادیر معتبر creativeCommon و youtube است.

  • تعریف پارامتر part برای روش‌های videos.list، videos.insert، و videos.update به‌روز شده است تا بخش‌های جدیداً اضافه‌شده که در بالا شرح داده شد و همچنین بخش recordingDetails را که به‌طور ناخواسته حذف شده بود فهرست کند.

  • ویژگی جدید contentDetails.googlePlusUserId منبع channel شناسه نمایه Google+‎ مرتبط با کانال را مشخص می‌کند. از این مقدار می‌توان برای تولید پیوندی به نمایه Google+‎ استفاده کرد.

  • هر شیء تصویر کوچک اکنون عرض و ارتفاع تصویر را مشخص می‌کند. تصاویر ریزعکس درحال‌حاضر در منابع activity، channel، playlist، playlistItem، search result، subscription، و video برگردانده می‌شوند.

  • playlistItems.list اکنون از پارامتر videoId پشتیبانی می‌کند که می‌تواند همراه با پارامتر playlistId برای بازیابی فقط مورد فهرست پخشی که ویدیو مشخص‌شده را نشان می‌دهد استفاده شود.

    اگر ویدیویی که پارامتر شناسایی می‌کند در فهرست پخش پیدا نشود، API خطای notFound را برمی‌گرداند.

  • اسناد خطا خطای جدید forbidden را شرح می‌دهد که نشان می‌دهد درخواست برای کنش درخواست‌شده به‌درستی مجاز نشده است.

  • ویژگی snippet.channelId منبع channel برداشته شده است. خصوصیت id منبع همان مقدار را ارائه می‌دهد.

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

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

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

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

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

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

  • اکنون منبع activity می‌تواند کنش channelItem را گزارش کند، که وقتی اتفاق می‌افتد که YouTube ویدیویی را به کانال YouTube تولیدشده به‌طور خودکار اضافه می‌کند. (YouTube موضوعاتی را که حضور قابل‌توجهی در وب‌سایت YouTube دارند به‌صورت الگوریتمی شناسایی می‌کند و به‌طور خودکار کانال‌هایی برای آن موضوعات ایجاد می‌کند.)

  • پارامترهای search.list زیر به‌روزرسانی شده‌اند:

    • پارامتر q دیگر به‌عنوان فیلتر تعیین نمی‌شود، یعنی ...
    • نام پارامتر relatedToVideo به relatedToVideoId تغییر کرده است.
    • پارامتر published با دو پارامتر جدید، publishedAfter و publishedBefore، جایگزین شده است که در زیر شرح داده شده‌اند.

  • روش search.list از پارامترهای جدید زیر پشتیبانی می‌کند:

    نام پارامتر مقدار شرح
    channelId string منابع ایجادشده توسط کانال مشخص‌شده را برمی‌گرداند.
    publishedAfter datetime منابع ایجادشده پس‌از زمان مشخص‌شده را برمی‌گرداند.
    publishedBefore datetime منابع ایجادشده قبل‌از زمان مشخص‌شده را برمی‌گرداند.
    regionCode string منابع را برای کشور مشخص‌شده برگردانید.
    videoCategoryId string نتایج جستجوی ویدیو را فیلتر کنید تا فقط ویدیوهای مرتبط با دسته ویدیو مشخص‌شده را شامل شود.
    videoEmbeddable string نتایج جستجوی ویدیو را فیلتر کنید تا فقط ویدیوهایی را شامل شود که می‌توانند در پخش‌کننده جاسازی‌شده در صفحه وب پخش شوند. مقدار پارامتر را روی true تنظیم کنید تا فقط ویدیوهای جاسازی‌شدنی بازیابی شوند.
    videoSyndicated string نتایج جستجوی ویدیو را فیلتر کنید تا فقط شامل ویدیوهایی باشد که می‌توانند خارج از YouTube.com پخش شوند. مقدار پارامتر را روی true تنظیم کنید تا فقط ویدیوهای هم‌زمان‌شده بازیابی شوند.

  • چندین منبع API از ویژگی‌های جدید پشتیبانی می‌کنند. جدول زیر منابع و ویژگی‌های جدید آن‌ها را مشخص می‌کند:

    منبع نام دارایی مقدار شرح
    activity contentDetails.playlistItem.playlistItemId string شناسه مورد فهرست پخش که YouTube برای شناسایی یکتای مورد در فهرست پخش اختصاص داده است.
    activity contentDetails.channelItem object شیئی که حاوی اطلاعاتی درباره منبعی است که به کانال اضافه شده است. این ویژگی فقط درصورتی وجود دارد که snippet.type برابر با channelItem باشد.
    activity contentDetails.channelItem.resourceId object شیئی که منبع اضافه‌شده به کانال را شناسایی می‌کند. مانند سایر ویژگی‌های resourceId، این ویژگی نیز شامل یک ویژگی kind است که نوع منبع را مشخص می‌کند، مانند ویدیو یا فهرست پخش. همچنین دقیقاً حاوی یکی از چند ویژگی – videoId، playlistId، و غیره – است که شناسه‌ای را مشخص می‌کند که به‌طور منحصربه‌فرد آن منبع را شناسایی می‌کند.
    channel status object این شیء اطلاعات مربوط به وضعیت حریم خصوصی کانال را کپسوله می‌کند.
    channel status.privacyStatus string وضعیت حریم خصوصی کانال. مقادیر معتبر private و public است.
    playlist contentDetails object این شیء حاوی فراداده درباره محتوای فهرست پخش است.
    playlist contentDetails.itemCount unsigned integer تعداد ویدیوها در فهرست پخش.
    playlist player object این شیء حاوی اطلاعاتی است که برای پخش فهرست پخش در پخش‌کننده جاسازی‌شده استفاده می‌کنید.
    playlist player.embedHtml string یک برچسب <iframe> که پخش‌کننده ویدیویی را جاسازی می‌کند که فهرست پخش را پخش می‌کند.
    video recordingDetails object این شیء اطلاعاتی را که مکان و زمان ضبط ویدیو را شناسایی یا توصیف می‌کند، کپسوله می‌کند.
    video recordingDetails.location object این شیء حاوی اطلاعات موقعیت جغرافیایی مرتبط با ویدیو است.
    video recordingDetails.location.latitude double عرض جغرافیایی به درجه.
    video recordingDetails.location.longitude double طول جغرافیایی به درجه.
    video recordingDetails.location.elevation double ارتفاع از سطح زمین، به متر.
    video recordingDetails.locationDescription string توضیحات نوشتاری مکانی که ویدیو در آن ضبط شده است.
    video recordingDetails.recordingDate datetime تاریخ و زمان ضبط ویدیو. این مقدار در قالب ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) مشخص شده است.

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

    توجه: مستندات مربوط به روش‌های دیگر ممکن است ازقبل ویژگی‌های لازم و قابل‌اصلاح را فهرست کرده باشد.

    روش مشخصات
    activities.insert خصوصیات لازم:
    • snippet.description
    ویژگی‌های قابل‌تغییر:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update خصوصیات لازم:
    • id
    playlistItems.update خصوصیات لازم:
    • id
    videos.update خصوصیات لازم:
    • id

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

  • چند روش API از انواع خطای جدید پشتیبانی می‌کنند. جدول زیر روش و خطاهای جدیدی را که پشتیبانی می‌شود مشخص می‌کند:

    روش نوع خطا جزئیات خطا شرح
    guideCategories.list notFound notFound دسته راهنمای شناسایی‌شده با پارامتر id پیدا نشد. از روش guideCategories.list برای بازیابی فهرست مقادیر معتبر استفاده کنید.
    playlistItems.delete forbidden playlistItemsNotAccessible درخواست برای حذف مورد فهرست پخش مشخص‌شده به‌درستی مجاز نیست.
    videoCategories.list notFound videoCategoryNotFound دسته ویدیو شناسایی‌شده با پارامتر id پیدا نشد. از روش videoCategories.list برای بازیابی فهرست مقادیر معتبر استفاده کنید.