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

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

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

تعریف منبع 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 را مشخص کرد:

• videos.insert
• videos.update
• videos.list

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

• ‫channelId: شناسه کانال خارجی نمانام شریک.
• channelHandle: نام کاربری کانال شریک نمانام.

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

‫۲۳ ژوئن ۲۰۲۶

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

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

‫۳ ژوئن ۲۰۲۶

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

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

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

‫۱ ژوئن ۲۰۲۶

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

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

تماس‌های API با روش‌های 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 برگردانده می‌شود.

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

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

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

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

‫۱۳ مارس ۲۰۲۴

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

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

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

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

۱۲ مارس ۲۰۲۴

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

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

۷ مارس ۲۰۲۴

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

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

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

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

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

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

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

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

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

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

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

۲۲ اوت ۲۰۲۳

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

۱۸ اوت ۲۰۲۳

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

‫۷ اوت ۲۰۲۳

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

‫۲۸ ژوئن ۲۰۲۳

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

۱۲ ژوئن ۲۰۲۳

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

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

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

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

‫۲۲ اوت ۲۰۲۲

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

۵ اوت ۲۰۲۲

‫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، منبع video statistics.dislikeCount اکنون خصوصی است.

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

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

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

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

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

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

‫۲ ژوئیه ۲۰۲۱

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

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

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

‫۱ ژوئیه ۲۰۲۱

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

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

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

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

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

‫۱۲ مه ۲۰۲۱

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

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

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

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

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

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

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

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

  • 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 از مستندات برداشته شده است. While users' watch history and watch later lists are, indeed, not accessible via the API, these particular errors are not returned by the API.

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

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

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

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

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

‫۸ اکتبر ۲۰۲۰

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

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

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

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

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

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

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

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

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

به‌شدت توصیه می‌کنیم که همه توسعه‌دهندگان برای پروژه‌هایشان ممیزی رعایت استانداردها را تکمیل کنند تا دسترسی به «خدمات YouTube API» را تضمین کنند.

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

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

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

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

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

۲۱ ژوئیه ۲۰۲۰

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

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

۷ ژوئیه ۲۰۲۰

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

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

۱۵ ژوئن ۲۰۲۰

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

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

۴ ژوئن ۲۰۲۰

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

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

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

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

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

۳۱ مارس ۲۰۲۰

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

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

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

    این منبع جایگزین منبع sponsor می‌شود که به‌عنوان بخشی از «میانای برنامه‌سازی کاربردی جاری‌سازی زنده YouTube» مستند شده است. منبع 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	‫۱٫۲۳ هزار
۱۲۳۴۵	12300	‫۱۲٫۳ هزار
‫۱۲۳٬۴۵۶	123000	‫۱۲۳ هزار
‫1,234,567	1230000	‫۱٫۲۳ میلیون
‫۱۲٬۳۴۵٬۶۷۸	12300000	‫۱۲٫۳ میلیون
‫۱۲۳٬۴۵۶٬۷۸۹	123000000	‫۱۲۳ میلیون

۴ آوریل ۲۰۱۹

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

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

  • ابزاره APIs 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 به‌روز شده‌اند. راهنماهای اصلاح‌شده توضیح می‌دهند که چگونه یک نمونه را با کلید API و نمونه دیگر را با شناسه کارخواه OAuth 2.0 بااستفاده از نمونه‌های کد از «کاوشگر API» اجرا کنید.

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

۹ ژوئیه ۲۰۱۸

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

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

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

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

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

۲۲ ژوئن ۲۰۱۸

راهنمای پیاده‌سازی، که قبلاً با نام «راهنمای پیاده‌سازی و انتقال» شناخته می‌شد، به‌روزرسانی شده است تا دستورالعمل‌های انتقال از میانای برنامه‌سازی کاربردی نسخه ۲ به میانای برنامه‌سازی کاربردی نسخه ۳ برداشته شود. علاوه‌براین، دستورالعمل‌های مربوط به ویژگی‌هایی که از زمان معرفی 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 فهرستی از جفت‌های کلید-مقدار مربوط به پارامترهای درخواست میانای برنامه‌سازی کاربردی را می‌گیرد و پارامترهایی را که مقدار ندارند حذف می‌کند.
  • تابع 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. به ابزار تعاملی تکه‌کد یا به اسناد مربوط به هر روش میانای برنامه‌سازی کاربردی، مانند روش 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 اکنون شامل مستنداتی است که برخی‌از ویژگی‌های ابزار را توضیح می‌دهد:
  • درحال اجرای درخواست‌های میانای برنامه‌سازی کاربردی
  • جابه‌جایی بین تکه‌کدها و نمونه‌های کد کامل
  • استفاده از توابع کلیشه‌ای
  • درحال بار کردن منابع موجود (برای روش‌های به‌روزرسانی)

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

۱ ژوئن ۲۰۱۷

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

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

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

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

۱۷ مه ۲۰۱۷

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

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

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

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

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

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

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

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

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

  • پشتیبانی از درخواست‌های API که داده‌ها را می‌نویسند.
  • پشتیبانی از نمونه‌های Java.
  • کد متن استاندارد جامع‌تر و انعطاف‌پذیرتر برای صدور مجوز برای کاربران و ساخت درخواست‌های 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» خود را برای این تغییرات آماده کنید، تعاریف پارامترها و دارایی‌های API زیر به‌روز شده است تا شناسه‌های موضوعی را که پس‌از آن زمان پشتیبانی خواهند شد فهرست کند. توجه داشته باشید که فهرست دسته‌ها برای همه دارایی‌ها یکسان است.

  • خصوصیت topicDetails.topicIds[] منبع channel.
  • خصوصیت topicDetails.relevantTopicIds[] منبع video.
  • پارامتر topicId روش search.list.

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

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

  • دارایی 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 تنظیم نشده باشد، «میانای برنامه‌سازی کاربردی» پخش‌کننده 960x540 را برمی‌گرداند.
    • اگر پارامتر maxWidth روی 960 تنظیم شده باشد و پارامتر maxHeight روی 450 تنظیم شده باشد، میانای برنامه‌سازی کاربردی پخش‌کننده ۸۰۰x۴۵۰ را برمی‌گرداند.

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

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

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

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

  • تعریف دارایی i18nLanguage در خصوصیت snippet.name اصلاح شده است تا نشان دهد که مقدار نشان‌دهنده نام زبان به همان شکلی است که در زبان مشخص‌شده توسط پارامتر 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 این خطا را برمی‌گرداند تا نشان دهد که درخواست API تلاش می‌کند یک تنظیم جاسازی نامعتبر برای ویدیو تنظیم کند. توجه داشته باشید که برخی کانال‌ها ممکن است اجازه ارائه پخش‌کننده‌های جاسازی‌شده برای جاری‌سازی‌های زنده را نداشته باشند. برای اطلاعات بیشتر، به مرکز راهنمایی YouTube مراجعه کنید.

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

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

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

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

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

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

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

  • اگر متد activities.list با پارامتر home تنظیم‌شده روی true فراخوانی شود، پاسخ API اکنون شامل مواردی مشابه با آنچه کاربر 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 مورد بحث قرار گرفته است، مجموعه غنی از به‌روزرسانی‌ها را برای «شرایط خدمات» فعلی ارائه می‌دهد. علاوه‌بر شرایط به‌روزشده که از ۱۰ فوریه ۲۰۱۷ اجرایی می‌شود، این به‌روزرسانی شامل چندین سند پشتیبانی است که به توضیح خط‌مشی‌هایی که توسعه‌دهندگان باید رعایت کنند کمک می‌کند.

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

• منسوخ شدن 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 به‌روزرسانی شده است تا اشاره کند که اندازه توصیه‌شده برای تصویر برنمای کانال بارگذاری‌شده ۲۵۶۰ پیکسل در ۱۴۴۰ پیکسل است. حداقل اندازه (۲۰۴۸ پیکسل در ۱۱۵۲ پیکسل) تغییر نکرده است.

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

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

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

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

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

    علاوه‌براین، روش 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 رده‌بندی ویدیو از «کمیسیون رده‌بندی فیلم فرانسه» را مشخص می‌کند. این خصوصیت جایگزین خصوصیت contentDetails.contentRating.fmocRating می‌شود که اکنون منسوخ شده است.

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

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

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

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

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

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

‫۲۸ اوت ۲۰۱۵

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

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

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

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

۷ اوت ۲۰۱۵

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

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

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

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

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

‫۱۸ ژوئن ۲۰۱۵

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

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

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

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

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

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

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

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

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

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

۲۷ آوریل ۲۰۱۵

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • targeting.languages[]: فهرستی از زبان‌های برنامه YouTube. کاربرانی که یکی از آن زبان‌ها را انتخاب کرده‌اند می‌توانند بخش کانال مربوطه را ببینند.

    • targeting.regions[]: فهرستی از مناطق محتوای ترجیحی YouTube. بخش کانال برای کاربرانی که یکی از آن مناطق را انتخاب کرده‌اند و همچنین کاربرانی که یکی از آن مناطق به‌طور خودکار برایشان انتخاب شده است قابل‌مشاهده است.

    • targeting.countries[]: فهرستی از کشورهایی که بخش کانال در آن‌ها قابل مشاهده است. هر مقدار در فهرست یک کد کشور ISO 3166-1 alpha-2 است.

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

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

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

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

    نوع خطا	جزئیات خطا	شرح
    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 API پشتیبانی نمی‌کرد اما در v3 API پشتیبانی می‌شوند، معرفی می‌کند. این موارد عبارت‌اند از:

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

• راهنمای مشترک شدن در اعلان‌های لحظه‌ای به‌روزرسانی شده است تا این واقعیت را نشان دهد که اعلان‌ها فقط به مرکز 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 لازم است.

• راهنمای جدید مشترک شدن در اعلان‌های لحظه‌ای پشتیبانی جدید API از اعلان‌های لحظه‌ای را ازطریق 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 مرتبط است.

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

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

• دامنه جدید 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) به‌روزرسانی شده است تا ذکر شود که API v3 از ویژگی API v2 زیر پشتیبانی خواهد کرد:

  • پرچم‌گذاری ویدیو

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

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

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

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

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

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

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

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

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

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

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

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

  • فهرست کردن ویدیوها براساس تاریخ انتشار، تعداد بازدید، یا رده‌بندی – در 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 (v3) نیز به‌روزرسانی شده است تا منسوخ شدن فیدهای ویژه و فیلدهای فراداده را که API v2 برای توصیف فیلم‌ها، پیش‌پرده‌ها، نمایش‌های تلویزیونی، فصل‌های تلویزیونی و قسمت‌های تلویزیونی ارائه می‌داد، نشان دهد.

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

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

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

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

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

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

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

• هزینه سهمیه برای فراخوانی روش 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	مشترک شناسایی‌شده با درخواست از حد نرخ اشتراک فراتر رفته است. چند ساعت دیگر می‌توانید برای اشتراک‌های بیشتر تلاش کنید.

‫۱۲ اوت ۲۰۱۴

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

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

‫۸ ژوئیه ۲۰۱۴

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

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

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

‫۱۸ ژوئن ۲۰۱۴

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

• شرح هر روش API به‌روز شده است تا هزینه سهمیه ناشی از فراخوانی آن روش را شامل شود. به‌طور مشابه، تعاریف پارامترهای part به‌روز شده‌اند تا هزینه سهمیه هر بخشی را که می‌تواند در یک فراخوانی API بازیابی شود، مشخص کنند. برای مثال، فراخوانی روش subscriptions.insert هزینه سهمیه‌ای حدود ۵۰ واحد دارد. منبع subscription نیز شامل سه بخش (snippet،‏ contentDetails، و subscriberSnippet) است و هریک از آن‌ها دو واحد هزینه دارد.

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

• منبع video اکنون از ۴۳ سیستم رده‌بندی محتوای جدید پشتیبانی می‌کند که رده‌بندی‌هایی را که ویدیوها از آژانس‌های رده‌بندی ملی مختلف دریافت کرده‌اند شناسایی می‌کند. سیستم‌های رده‌بندی جدیدی که پشتیبانی می‌شوند عبارتند از: آرژانتین، اتریش، بلژیک، بلغارستان، شیلی (تلویزیون)، شیلی (فیلم)، جمهوری چک، کلمبیا، دانمارک، مصر، استونی، فنلاند، فرانسه، یونان، هنگ‌کنگ، ایسلند، اندونزی، ایرلند، اسرائیل، ایتالیا، کنیا، لتونی، لوکزامبورگ، مالزی، مالدیو، مالت، هلند، نیجریه، نروژ، پرو، فیلیپین، پرتغال، رومانی، سنگاپور، اسلواکی، آفریقای جنوبی، سوئد، سوئیس، تایوان، تایلند، و ونزوئلا.

۲۸ مه ۲۰۱۴

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

• روش 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 به‌روز شده است تا ذکر شود که عبارت پُرسمان می‌تواند از عملگر «نه» بولی (-) برای حذف ویدیوهای مرتبط با یک عبارت جستجوی خاص استفاده کند. این مقدار همچنین می‌تواند از عملگر بولی OR (|) برای یافتن ویدیوهای مرتبط با یکی از چند عبارت جستجو استفاده کند.

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

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

۲ مه ۲۰۱۴

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

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

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

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

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

۷ آوریل ۲۰۱۴

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

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

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

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

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

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

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

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

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

‫۳۱ مارس ۲۰۱۴

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

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

۱۳ مارس ۲۰۱۴

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

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

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

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

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

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

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• اکنون مستندات خطا کد پاسخ 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 این خطا را برمی‌گرداند.

۴ مارس ۲۰۱۴

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

• YouTube Data API، نسخه ۳ اکنون مشمول «خط‌مشی منسوخ کردن» است که در شرایط خدمات YouTube APIs شرح داده شده است. توجه داشته باشید که صفحه‌ای که میاناهای برنامه‌سازی کاربردی مشمول خط‌مشی منسوخ کردن را فهرست می‌کند، به‌طور خاص برخی‌از عملکردهای میانای برنامه‌سازی کاربردی نسخه ۳ را از مشمول شدن در این خط‌مشی مستثنی می‌کند.

۵ دسامبر ۲۰۱۳

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

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

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

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

• حداقل اندازه تصاویر برنمای کانال بارگذاری‌شده به ۲۰۴۸ پیکسل در ۱۱۵۲ پیکسل کاهش یافته است. (قبلاً، حداقل اندازه ۲۱۲۰ پیکسل در ۱۱۹۲ پیکسل بود.) علاوه‌براین، توجه داشته باشید که مستندات منبع channel حداکثر اندازه‌های همه تصاویر برنمایی که از API ارائه می‌شود را مشخص می‌کند. برای مثال، حداکثر اندازه تصویر 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 نشان می‌دهد که آیا ویدیوهای به‌روزشده یا ویدیوهای تازه‌بارگذاری‌شده می‌توانند با آن دسته ویدیو مرتبط شوند یا نه.

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

  • activities.insert (رفتن)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (رفتن)
  • search.list (رفتن)
  • ‫thumbnails.set (Java)
  • videos.insert (رفتن)

۲۴ اکتبر ۲۰۱۳

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

• این 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 بگنجانید.

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

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

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

• روش‌های 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 تصمیم به پذیرش یا رد کانال می‌گیرد یا ظرف دو هفته از تاریخ صدور نشانه، لغو شود.

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

  به‌طور پیش‌فرض، کانال همان کانالی است که داده‌های تبلیغ درون‌ویدیویی برای آن تنظیم شده است. بااین‌حال، می‌توانید با تنظیم مقدار ویژگی جدید 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 ایتالیا دریافت کرده است شناسایی می‌کند.

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

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

‫۲۷ اوت ۲۰۱۳

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

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

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

  اسناد خطا پیام‌های خطایی را که میانای برنامه‌سازی کاربردی به‌طور خاص برای روش‌های 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 پشتیبانی می‌کند. هر دو پارامتر ازقبل برای چندین روش دیگر پشتیبانی می‌شوند.

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

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

  • ‫channels.update (Java،‏ Python)
  • ‫playlists.insert ‏ (.NET،‏ PHP)
  • subscriptions.insert (PHP، پایتون)
  • thumbnails.set (PHP،‏ Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (پایتون)
  • videos.update (Java،‏ PHP،‏ Python)

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

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

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

‫۸ اوت ۲۰۱۳

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

• بخش استفاده از سهمیه در راهنمای شروع به کار با YouTube Data API به‌روزرسانی شده است تا تغییر هزینه سهمیه بارگذاری ویدیو را از حدود ۱۶۰۰۰ واحد به حدود ۱۶۰۰ واحد نشان دهد.

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

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

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

• دارایی جدید channel منبع brandingSettings.channel.profileColor رنگ برجسته‌ای را مشخص می‌کند که مکمل محتوای کانال است. مقدار ویژگی یک علامت پوند (#) است که به‌دنبال آن یک رشته شانزده‌شانزدهی شش نویسه‌ای، مانند #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 به‌روز شده است تا این واقعیت را منعکس کند که از این روش می‌توان برای به‌روزرسانی منبع channel، شیء brandingSettings، و دارایی‌های فرزند آن استفاده کرد. این اسناد اکنون فهرست به‌روزشده‌ای از دارایی‌هایی را که می‌توانید برای شیء invideoPromotion منبع channel تنظیم کنید نیز ارائه می‌دهد.

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

  نوع خطا	جزئیات خطا	شرح
  forbidden	accountDelegationForbidden	این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. این خطا نشان می‌دهد که کاربر اصالت‌سنجی‌شده مجاز نیست ازطرف حساب Google مشخص‌شده اقدام کند.
  forbidden	authenticatedUserAccountClosed	این خطا مربوط به روش خاصی در میانای برنامه‌سازی کاربردی نیست. این خطا نشان می‌دهد که حساب YouTube کاربر اصالت‌سنجی‌شده بسته شده است. اگر کاربر ازطرف «حساب Google» دیگری اقدام می‌کند، این خطا نشان می‌دهد که آن حساب دیگر بسته شده است.
  forbidden	authenticatedUserAccountSuspended	این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. این خطا نشان می‌دهد که حساب YouTube کاربر اصالت‌سنجی‌شده تعلیق شده است. اگر کاربر ازطرف «حساب Google» دیگری اقدام می‌کند، این خطا نشان می‌دهد که آن حساب دیگر تعلیق شده است.
  forbidden	authenticatedUserNotChannel	این خطا مربوط به روش خاصی در میانای برنامه‌سازی کاربردی نیست. این خطا نشان می‌دهد که سرور API نمی‌تواند کانال مرتبط با درخواست API را شناسایی کند. اگر درخواست مجاز باشد و از پارامتر 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 مشخص می‌کند پیوند داده شود.

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

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

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

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

  نوع خطا	جزئیات خطا	شرح
  forbidden	insufficientCapabilities	این خطا مختص روش میانای برنامه‌سازی کاربردی خاصی نیست. این خطا نشان می‌دهد که کاربر «سیستم مدیریت محتوا» که 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 را فهرست می‌کند اکنون شامل نمونه‌هایی برای افزودن اشتراک، ایجاد فهرست پخش، و به‌روزرسانی ویدیو است.

۱۰ مه ۲۰۱۳

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

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

۸ مه ۲۰۱۳

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

• منابع کانال اکنون از شیء 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 حداکثر تعداد ویدیوهایی را که API می‌تواند در مجموعه نتایج برگرداند مشخص می‌کند و پارامتر pageToken صفحه خاصی را در مجموعه نتایج که می‌خواهید بازیابی کنید شناسایی می‌کند.

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

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

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

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

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

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

  • activities.insert (یاقوت سرخ)
  • ‫playlistItems.list (.NET)
  • ‫search.list‏ (.NET)
  • subscriptions.insert (جاوا، روبی)
  • ‫videos.insert ‏ (.NET،‏ Ruby)

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

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

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

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

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

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

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

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

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

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

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

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

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

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

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

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

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

  • دارایی status.publicStatsViewable نشان می‌دهد که آیا آمار ویدیو گسترده در صفحه تماشا برای عموم قابل مشاهده است یا خیر. به‌طور پیش‌فرض، این آمار قابل مشاهده است و آماری مانند تعداد بازدید و رده‌بندی ویدیو همچنان به‌صورت عمومی قابل مشاهده خواهد بود، حتی اگر مقدار این دارایی روی false تنظیم شده باشد. می‌توانید مقدار این ویژگی را هنگام فراخوانی روش videos.insert یا videos.update تنظیم کنید.

  • شیء contentDetails.contentRating رده‌بندی‌هایی را که ویدیو تحت طرح‌های رده‌بندی مختلف دریافت کرده است دربرمی‌گیرد. فهرست زیر سیستم‌های رده‌بندی پشتیبانی‌شده را مشخص می‌کند و پیوندی به دارایی مرتبط با هر سیستم رده‌بندی ارائه می‌دهد. تعاریف ویژگی مقادیر رده‌بندی پشتیبانی‌شده را برای هر سیستم مشخص می‌کند.

    کشور	سیستم رده‌بندی	دارایی
    United States	انجمن سینمایی آمریکا (MPAA)	contentDetails.contentRating.mpaaRating
    United States	دستورالعمل‌های والدین درباره تلویزیون	contentDetails.contentRating.tvpgRating
    Australia	Australian Classification Board (ACB)	contentDetails.contentRating.acbRating
    Brazil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canada	سیستم رده‌بندی ویدیو خانگی کانادا (CHVRS)	contentDetails.contentRating.chvrsRating
    France	Centre national du cinéma et de l'image animée (وزارت فرهنگ فرانسه)	contentDetails.contentRating.fmocRating
    Germany	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Great Britain	British Board of Film Classification (BBFC) (هیئت طبقه‌بندی فیلم بریتانیا)	contentDetails.contentRating.bbfcRating
    India	هیئت مرکزی صدور پروانه فیلم (CBFC)	contentDetails.contentRating.cbfcRating
    Japan	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Korea	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    Mexico	اداره کل رادیو، تلویزیون و سینما (RTC)	contentDetails.contentRating.rtcRating
    New Zealand	دفتر طبقه‌بندی فیلم و ادبیات	contentDetails.contentRating.oflcRating
    Russia	ثبت ملی فیلم فدراسیون روسیه	contentDetails.contentRating.russiaRating
    Spain	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• اسناد روش 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 نشان می‌دهد که اطلاعات اعتباری مجوز درخواست، کاربر CMS YouTube را که ازطرف مالک محتوای مشخص‌شده در مقدار پارامتر اقدام می‌کند شناسایی می‌کند. حساب CMS که کاربر با آن اصالت‌سنجی می‌کند باید به مالک محتوای YouTube مشخص‌شده پیوند داده شود.

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

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

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

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

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

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

• این API از چندین بخش و دارایی جدید برای منابع 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 منبع مقدار یکسانی ارائه می‌دهد.

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

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

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

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

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

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

  • ‫activities.insert – جاوه
  • ‫playlistItems.insert – Python
  • playlistItems.list – Java،‏ JavaScript،‏ PHP،‏ Python،‏ Ruby
  • playlists.insert – Java،‏ JavaScript،‏ Python
  • search.list – Java،‏ JavaScript،‏ Python،‏ Ruby
  • ‫videos.insert – جاوه

• اکنون یک منبع 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 تنظیم کنید تا فقط ویدیوهای همه‌فرستی‌شده را بازیابی کنید.

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

  منبع	نام دارایی	مقدار	شرح
  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 برای بازیابی فهرست مقادیر معتبر استفاده کنید.