تاریخچه ویرایشهای

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

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

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

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

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

۲۷ اوت ۲۰۲۶

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

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

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

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

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

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

۶ آگوست ۲۰۲۶

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

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

۷ ژوئیه ۲۰۲۶

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

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

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

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

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

۲۳ ژوئن ۲۰۲۶

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

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

۳ ژوئن ۲۰۲۶

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

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

فراخوانی این متد، هزینه سهمیه‌ای معادل ۱ واحد در سطل سهمیه جزئی خود دارد. سهمیه پیش‌فرض این متد ۱۰۰۰۰ واحد در روز است.

۱ ژوئن ۲۰۲۶

رابط برنامه‌نویسی کاربردی داده یوتیوب (YouTube Data API) در حال گذار به یک سیستم سهمیه‌بندی جزئی است که مجموعه‌های کوچک‌تری از متدها را پوشش می‌دهد و از videos.insert و search.list شروع می‌شود.

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

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

۴ دسامبر ۲۰۲۵

مستندات API داده یوتیوب و محاسبه‌گر سهمیه به‌روزرسانی شده‌اند تا تغییر در هزینه سهمیه آپلود ویدیو را از تقریباً ۱۶۰۰ واحد به تقریباً ۱۰۰ واحد منعکس کنند.

۱۰ ژوئیه ۲۰۲۵

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

۲۶ مارس ۲۰۲۵

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

از ۳۱ مارس ۲۰۲۵، فیلدهای زیر در API داده، تعداد بازدیدها برای Shorts را طبق این تغییر برمی‌گردانند:

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

۳۰ اکتبر ۲۰۲۴

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

نمونه‌هایی از محتوای A/S شامل ویدیوهایی است که:

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

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

۳۰ آوریل ۲۰۲۴

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

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

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

۱۳ مارس ۲۰۲۴

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

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

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

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

۱۲ مارس ۲۰۲۴

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

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

۷ مارس ۲۰۲۴

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

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

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

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

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

۹ نوامبر ۲۰۲۳

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

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

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

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

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

۲۲ آگوست ۲۰۲۳

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

۱۸ آگوست ۲۰۲۳

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

۷ آگوست ۲۰۲۳

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

۲۸ ژوئن ۲۰۲۳

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

۱۲ ژوئن ۲۰۲۳

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

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

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

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

۲۲ آگوست ۲۰۲۲

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

۵ آگوست ۲۰۲۲

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

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

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

۱۲ ژوئیه ۲۰۲۲

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

۲۷ آوریل ۲۰۲۲

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

۸ آوریل ۲۰۲۲

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

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

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

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

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

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

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

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

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

۲ ژوئیه ۲۰۲۱

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

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

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

۱ ژوئیه ۲۰۲۱

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

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

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

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

جزئیات بیشتر در راهنمای جدید حسابرسی انطباق API ما موجود است.

۱۲ مه ۲۰۲۱

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

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

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

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

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

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

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

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

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

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

۱۵ اکتبر ۲۰۲۰

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

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

راهنمای جدید «یافتن وضعیت MadeForKids» برای یک ویدیو، نحوه‌ی جستجوی وضعیت MFK یک ویدیو را با استفاده از سرویس API داده‌ی یوتیوب توضیح می‌دهد.

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

۸ اکتبر ۲۰۲۰

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

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

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

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

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

  • منابع، متدها، پارامترها و ویژگی‌های منابع API زیر بلافاصله منسوخ می‌شوند و در تاریخ یا پس از تاریخ این اطلاعیه دیگر کار نخواهند کرد:
    • ویژگی‌های منبع channel زیر:
      • statistics.commentCount
      • شیء brandingSettings.image و تمام ویژگی‌های فرزند آن
      • لیست brandingSettings.hints و تمام ویژگی‌های فرزند آن
    • پارامتر فیلتر categoryId متد channels.list
    • منبع guideCategories و متد