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

این صفحه تغییرات API و به‌روزرسانی‌های اسناد را برای هر دو YouTube Reporting API و YouTube Analytics API فهرست می‌کند. هر دو API به توسعه‌دهندگان امکان می‌دهند به داده‌های YouTube Analytics دسترسی داشته باشند، اگرچه به روش‌های مختلف.

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

‫YouTube Reporting API اکنون از گزارش‌های مدیریت‌شده توسط سیستم زیر برای مالکان محتوا پشتیبانی می‌کند:

دسته نام گزارش شناسه نوع گزارش
خلاصه‌های مالی خلاصه اصلاحات ماهانه کانال content_owner_channel_adjustments_summary_a1
خلاصه‌های مالی درآمد ماهانه تراکنش‌های ویژگی‌های پولی content_owner_transactions_paid_features_revenue_a1
خلاصه‌های مالی درآمد ماهانه تراکنش‌های TVOD براساس عنوان و کشور tvod_content_owner_country_title_tvod_revenue_a1
خلاصه‌های مالی درآمد ماهانه تراکنش‌های ویدیو به‌درخواست با پرداخت براساس کشور tvod_content_owner_country_transactions_tvod_revenue_a1
کوته‌ویدیوها ایجاد دارایی‌های ماهانه فیلم‌های کوتاه YouTube ناشر موسیقی music_content_owner_shorts_asset_creations_a1
کوته‌ویدیوها بازدیدهای ماهانه دارایی‌های کوته‌ویدیوهای ناشر موسیقی music_content_owner_shorts_asset_views_a1
کوته‌ویدیوها ایجاد دارایی‌های ماهانه ناشر موسیقی برای فیلم‌های کوتاه publisher_content_owner_shorts_asset_creations_a1
کوته‌ویدیوها بازدیدهای ماهانه دارایی کوته‌ویدیوهای ناشر موسیقی publisher_content_owner_shorts_asset_views_a1
مالیات گزارش خلاصه استرداد مالیات ماهانه وابسته MCN content_owner_affiliate_tax_refund_summary_a1
دارایی‌ها گزارش هفتگی SRMF publisher_content_owner_weekly_srmf
دارایی‌ها گزارش روزانه وضعیت درخواست «کانال رسمی هنرمند» content_owner_oac_request_status_a1
دارایی‌ها گزارش کیفیت درخواست روزانه «کانال رسمی هنرمند» content_owner_oac_quality_status_a1

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

‫YouTube Reporting API اکنون از نسخه ۱.۱ گزارش هفتگی مرجع‌ها برای مالکان محتوا (content_owner_active_references_a2) پشتیبانی می‌کند.

نسخه ۱.۱ تغییرات زیر را معرفی می‌کند:

  • فیلد status_detail را اضافه می‌کند که جزئیات یا دلیل بیشتری درباره وضعیت فایل مرجع ارائه می‌دهد.
  • فیلد asset_owners را به‌روزرسانی می‌کند تا به‌جای کدهای شریک از نام‌های نمایشی مالک محتوا یا شناسه‌های خارجی استفاده کند.

نسخه قبلی گزارش، نسخه ۱.۰ (content_owner_active_references_a1)، همچنان دردسترس است.

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

اسناد YouTube Analytics API و YouTube Reporting API با موارد اضافه‌شده و توضیحات زیر به‌روزرسانی شده‌اند:

  • قرارداد سطح خدمات برای تأخیر و تازگی داده‌ها: بخش اختصاصی‌ای به مدل داده اضافه شد که تأخیر ۴۸ تا ۷۲ ساعته پردازش داده‌ها و کوتاه کردن تاریخ پایان به آخرین روزی که پردازش کامل شده است را توضیح می‌دهد و روش YouTube Data API videos.list را برای آمار هم‌زمان ویدیو توصیه می‌کند.

  • سنجه‌های پولی در گزارش‌های کانال: سند صدور مجوز گزارش‌های کانال به‌روزرسانی شد تا شفاف‌سازی شود که سنجه‌های درآمد تخمینی و عملکرد آگهی برای گزارش‌های کانال دارای مجوز با دامنه https://www.googleapis.com/auth/yt-analytics-monetary.readonly پشتیبانی می‌شوند، مشروط بر اینکه کانال عضو «برنامه شریک YouTube» (YPP) باشد، و کانال‌های بدون درآمدزایی HTTP 403 Forbidden را برمی‌گردانند.

  • محدودیت‌های پُرسمان و سازگاری پارامتر: یادداشت مشاوره‌ای به درک جدول‌های گزارش اضافه شد که توضیح می‌دهد ترکیب‌های نامعتبر یا ناسازگار بُعد، سنجه، و فیلتر، HTTP 400 badRequest ("The query is not supported.") را برمی‌گرداند.

  • مقادیر بُعد خالی در گزارش‌های انبوه: ویژگی‌های گزارش YouTube Reporting API به‌روزرسانی شد تا توضیح دهد که ستون‌های بُعد مانند video_id یا channel_id حاوی رشته‌های خالی هستند تا تعداد سنجه‌های انبوه برای منابع حذف‌شده حفظ شود و رویدادهای سطح کانال نمایش داده شود.

‫۲۷ اوت ۲۰۲۶

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

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

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

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

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

به‌روزرسانی‌های اسناد API: تعریف سنجه engagedViews در اسناد سنجه‌های YouTube Analytics API و سنجه‌های YouTube Reporting API به‌روزرسانی شد.

‫۲۵ ژوئن ۲۰۲۶

سند YouTube Analytics API (پُرسمان‌های هدف‌گیری‌شده) به‌روزرسانی شده است تا گزارش فعالیت کاربر براساس شهر برای مالکان محتوا برداشته شود. این گزارش برای مالکان محتوا پشتیبانی نمی‌شود؛ پُرسمان‌های مالک محتوا برای فعالیت کاربر براساس شهر نتایج خالی برمی‌گرداند.

‫۹ مارس ۲۰۲۶

ابعاد ageGroup (YouTube Analytics API) و age_group (YouTube Reporting API) اکنون شامل کاربرانی است که YouTube تخمین می‌زند زیر ۱۸ سال سن دارند.

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

‫YouTube Reporting API اکنون از گزارش‌های دسترسی برای کانال‌ها و مالکان محتوا پشتیبانی می‌کند. گزارش‌های دسترسی آماری برای ظهورهای ریزعکس ویدیو و نرخ‌های کلیک‌گذری ارائه می‌دهند.

  • گزارش‌های channel_reach_basic_a1 و channel_reach_combined_a1 برای کانال‌ها دردسترس است.
  • گزارش‌های content_owner_reach_basic_a1 و content_owner_reach_combined_a1 برای مالکان محتوا دردسترس هستند.

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

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

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

منسوخ شدن گزارش‌ها که قبلاً اعلام شده بود از ۳۰ سپتامبر ۲۰۲۵ به ۳۱ اکتبر ۲۰۲۵ به‌تعویق افتاده است. نسخه‌های قبلی گزارش‌های به‌روزشده برای تغییرات تعداد بازدید «کوته‌ویدیوها» تا آن زمان همچنان دردسترس خواهند بود، به‌استثنای گزارش «ادعاها» نسخه ۱.۰ (content_owner_active_claims_a1) و گزارش «ادعاها» نسخه ۱.۱ (content_owner_active_claims_a2) که همچنان در ۳۰ سپتامبر منسوخ خواهند شد.

‫۲۴ ژوئن ۲۰۲۵

همان‌طور که در ۲۶ مارس ۲۰۲۵ اعلام شد، Bulk Reports API به‌عنوان بخشی از تغییر جدید تعداد بازدیدهای «کوته‌ویدیوها» به‌روزرسانی خواهد شد. تغییرات زیر اعمال شده است:

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

این تغییرات از ۳۰ ژوئن ۲۰۲۵ برای Bulk Reports API اعمال می‌شود. حتماً پردازش گزارش را براین‌اساس تنظیم کنید.

نسخه‌های قبلی گزارش تا ۳۰ سپتامبر ۲۰۲۵ دردسترس خواهد بود. پس‌از ۳۰ سپتامبر ۲۰۲۵، نسخه‌های قبلی منسوخ خواهند شد. حتماً به جدیدترین نسخه‌ها م��ا��ر�� کنید.

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

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

گزارش‌های انبوه داده برای YouTube Analytics

گزارش‌های کانال - گزارش‌های ویدیو
نام گزارش نسخه قبلی جدیدترین نسخه
فعالیت کاربر channel_basic_a2 channel_basic_a3
فعالیت کاربر براساس استان channel_province_a2 channel_province_a3
مکان‌های بازپخش channel_playback_location_a2 channel_playback_location_a3
منابع ترافیک channel_traffic_source_a2 channel_traffic_source_a3
نوع دستگاه و سیستم‌عامل channel_device_os_a2 channel_device_os_a3
زیرنویس‌ها channel_subtitles_a2 channel_subtitles_a3
ترکیبی channel_combined_a2 channel_combined_a3
گزارش‌های کانال - گزارش‌های فهرست پخش
نام گزارش نسخه قبلی جدیدترین نسخه
فعالیت کاربر playlist_basic_a1 playlist_basic_a2
فعالیت کاربر براساس استان playlist_province_a1 playlist_province_a2
مکان‌های بازپخش playlist_playback_location_a1 playlist_playback_location_a2
منابع ترافیک playlist_traffic_source_a1 playlist_traffic_source_a2
نوع دستگاه و سیستم‌عامل playlist_device_os_a1 playlist_device_os_a2
ترکیبی playlist_combined_a1 playlist_combined_a2
گزارش‌های مالک محتوا - گزارش‌های ویدیو
نام گزارش نسخه قبلی جدیدترین نسخه
فعالیت کاربر content_owner_basic_a3 content_owner_basic_a4
فعالیت کاربر براساس استان content_owner_province_a2 content_owner_province_a3
مکان‌های بازپخش content_owner_playback_location_a2 content_owner_playback_location_a3
منابع ترافیک content_owner_traffic_source_a2 content_owner_traffic_source_a3
نوع دستگاه و سیستم‌عامل content_owner_device_os_a2 content_owner_device_os_a3
زیرنویس‌ها content_owner_subtitles_a2 content_owner_subtitles_a3
ترکیبی content_owner_combined_a2 content_owner_combined_a3
گزارش‌های مالک محتوا - گزارش‌های فهرست پخش
نام گزارش نسخه قبلی جدیدترین نسخه
فعالیت کاربر content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
فعالیت کاربر براساس استان content_owner_playlist_province_a1 content_owner_playlist_province_a2
مکان‌های بازپخش content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
منابع ترافیک content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
نوع دستگاه و سیستم‌عامل content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
ترکیبی content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
گزارش‌های مالک محتوا - گزارش‌های دارایی
نام گزارش نسخه قبلی جدیدترین نسخه
فعالیت کاربر content_owner_asset_basic_a2 content_owner_asset_basic_a3
فعالیت کاربر براساس استان content_owner_asset_province_a2 content_owner_asset_province_a3
مکان‌های بازپخش ویدیو content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
منابع ترافیک content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
نوع دستگاه و سیستم‌عامل content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
ترکیبی content_owner_asset_combined_a2 content_owner_asset_combined_a3

گزارش‌های مدیریت‌شده توسط سیستم - مالی (غیرموسیقی)

گزارش‌های مالک محتوا - گزارش‌های «کوته‌ویدیوها» (غیرموسیقی)
نام گزارش نسخه قبلی جدیدترین نسخه
خلاصه درآمد آگهی جهانی content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
خلاصه درآمد آگهی روزانه content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
خلاصه درآمد آگهی کشور content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
خلاصه درآمد آگهی content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

گزارش‌های تحت مدیریت سیستم - غیرمالی

گزارش‌های مالک محتوا - گزارش‌های ادعا
نام گزارش نسخه قبلی جدیدترین نسخه
ادعاهای فعال content_owner_active_claims_a2 content_owner_active_claims_a3
گزارش‌های مالک محتوا - گزارش‌های فراداده ویدیو
نام گزارش نسخه قبلی جدیدترین نسخه
فوق داده ویدیو content_owner_video_metadata_a3 content_owner_video_metadata_a4
گزارش‌های مالک محتوا - گزارش‌های دارایی
نام گزارش نسخه قبلی جدیدترین نسخه
دارایی‌ها content_owner_asset_a2 content_owner_asset_a3
تداخل دارایی content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

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

همان‌طور که در ۲۶ مارس ۲۰۲۵ اعلام شد، Targeted Queries API به‌عنوان بخشی از تغییر جدید تعداد بازدیدهای «کوته‌ویدیوها» به‌روزرسانی خواهد شد:

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

این تغییرات از ۳۰ آوریل ۲۰۲۵ برای Targeted Queries API اعمال خواهد شد. حتماً پُرسمان‌هایتان را بر این اساس تنظیم کنید.

این سابقه ویرایش را بررسی کنید تا ببینید چه تغییراتی و در چه زمانی در Bulk Reports API اعمال خواهد شد.

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

همان‌طور که در ۷ آوریل ۲۰۲۴ اعلام شد، بُعد isCurated برای گزارش‌های کانال و گزارش‌های فهرست پخش مالک محتوا منسوخ شده است. از ۳۱ دسامبر ۲۰۲۴، این بُعد دیگر پشتیبانی نمی‌شود. این بُعد از گزارش‌ها و اسناد برداشته شده است.

‫۲۶ مارس ۲۰۲۵

این به‌روزرسانی حاوی تغییرات زیر دررابطه‌با YouTube Analytics و APIهای گزارش‌دهی است:

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

‫YouTube Analytics (پُرسمان‌های هدف‌گیری‌شده) و Reporting (گزارش‌های انبوه) API با تغییرات زیر به‌روزرسانی خواهند شد:

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

«پُرسمان‌های هدف‌گیری‌شده» تا ۳۰ آوریل و «گزارش‌های انبوه» تا ۳۰ ژوئن به‌روزرسانی خواهند شد. تا آن زمان، بازدیدها براساس روش قدیمی خواهد بود. بازدیدهای «کوته‌ویدیوها» و کانال با Analytics در «استودیو» مطابقت نخواهد داشت.

علاوه‌براین، منسوخ شدن گزارش «ادعاهای روزانه» (نسخه ۱٫۰) که قبلاً اعلام شده بود به‌تأخیر افتاده است.

این سابقه ویرایش را بررسی کنید تا بدانید چه زمانی تغییرات در APIها اعمال شده است.

‫۳ مارس ۲۰۲۵

این به‌روزرسانی حاوی تغییرات زیر دررابطه‌با YouTube Reporting API است:

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

گزارش ادعاهای روزانه (نسخه ۱.۰) برای شرکا منسوخ شده است. از ۳۰ آوریل ۲۰۲۵ دیگر پشتیبانی نخواهد شد. تعریف آن گزارش براین‌اساس به‌روز شده است. به‌جای آن از جدیدترین گزارش «ادعاهای روزانه» استفاده کنید.

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

توجه: تغییر زیر از ۱۸ نوامبر ۲۰۲۴ اجرایی می‌شود.

اسناد YouTube Analytics (Targeted Queries) API به‌روزرسانی شده است تا نشان دهد که برای گزارش‌های منبع ترافیک، روش reports.query API اکنون اگر حاصل‌ضرب تعداد ویدیوهای پُرسمان‌شده در تعداد روزها در محدوده تاریخ بیش‌از ۵۰٬۰۰۰ باشد، خطا برمی‌گرداند. برای مثال، پُرسمانی که داده‌های ۵۰۰ شناسه ویدیو را بازیابی می‌کند می‌تواند حداکثر برای ۱۰۰ روز داده درخواست کند.

این تغییر بر گزارش‌های کانال‌ها و مالکان محتوا تأثیر می‌گذارد.

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

۶ مه ۲۰۲۴

‫YouTube Analytics (Targeted Queries) API از سه گزارش جدید برای کانال‌ها پشتیبانی می‌کند:

علاوه‌براین، گزارش حفظ مخاطب برای پشتیبانی از سه سنجه جدید بهبود یافته است:

‫۷ آوریل ۲۰۲۴

‫YouTube Analytics (Targeted Queries) API چندین به‌روزرسانی مربوط به گزارش‌های فهرست پخش مالک محتوا دارد. این به‌روزرسانی‌ها همان به‌روزرسانی‌های مربوط به گزارش‌های فهرست پخش کانال هستند که در ۱۹ ژانویه ۲۰۲۴ اعلام شدند.

ورودی سابقه ویرایش زیر تقریباً همان اطلاعات ورودی ۱۹ ژانویه ۲۰۲۴ را ارائه می‌دهد. بااین‌حال، توجه داشته باشید که گزارش‌های فهرست پخش مالک محتوا تا ۳۱ دسامبر ۲۰۲۴ از بُعد isCurated پشتیبانی خواهند کرد، درحالی‌که این بُعد برای گزارش‌های فهرست پخش کانال تا ۳۰ ژوئن ۲۰۲۴ پشتیبانی خواهد شد.

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

    بُعد isCurated برای گزارش‌های فهرست پخش مالک محتوا منسوخ شده است. از ۳۱ دسامبر ۲۰۲۴ دیگر پشتیبانی نخواهد شد. تعریف آن بُعد براین‌اساس به‌روز شده است.

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

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

    • فیلترهای مکان، مانند continent و subcontinent، برای گزارش‌های فهرست پخش کانال جدید پشتیبانی نمی‌شوند.
    • سنجه‌های redViews و estimatedRedMinutesWatched دیگر برای گزارش‌های فهرست پخش کانال جدید پشتیبانی نمی‌شوند. این سنجه‌ها در «استودیوِ YouTube» دردسترس نبوده‌اند، بنابراین این تغییر عملکرد میانای برنامه‌سازی کاربردی را با عملکرد دردسترس در برنامه «استودیو» همسو می‌کند.
    • بعدهای subscribedStatus و youtubeProduct دیگر به‌عنوان فیلتر برای گزارش‌های فهرست پخش کانال پشتیبانی نمی‌شوند. این فیلترها در «استودیوِ YouTube» دردسترس نبوده‌اند، بنابراین این تغییر عملکرد میانای برنامه‌سازی کاربردی را با عملکرد دردسترس در برنامه «استودیو» همسو می‌کند.

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

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

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

  • رفتار سنجه views اکنون به این بستگی دارد که آیا درخواست API که گزارش فهرست پخش را بازیابی کرده است از بُعد isCurated استفاده کرده است یا نه:

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

      در این گزارش‌ها که از بُعد isCurated استفاده نمی‌کنند، سنجه playlistViews نشان‌دهنده تعداد دفعاتی است که ویدیوها در زمینه فهرست پخش مشاهده شده‌اند. این سنجه بازدیدهای همه ویدیوهای فهرست پخش را می‌شمارد، صرف‌نظر از اینکه کدام کانال مالک آن‌ها است.

  • برای ه�� گزارش فهرست پخش، اسناد گزارش‌های مالک محتوا اکنون شامل جدول‌هایی است که سنجه‌های پشتیبانی‌شده برای آن گزارش را نشان می‌دهد، بسته به اینکه درخواست API شامل بُعد isCurated باشد یا نه. برای دیدن نمونه، به بخش تعریف گزارش‌های فهرست پخش زمان‌محور مراجعه کنید.

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

‫YouTube Analytics (Targeted Queries) API چندین به‌روزرسانی مربوط به گزارش‌های فهرست پخش کانال دارد. این به‌روزرسانی‌ها شامل یک بُعد منسوخ‌شده و چند سنجه جدید و به‌روزشده است:

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

    بُعد isCurated برای گزارش‌های کانال منسوخ شده است. از ۳۰ ژوئن ۲۰۲۴ دیگر پشتیبانی نخواهد شد. تعریف آن بُعد نیز به‌روز شده است.

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

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

    • فیلترهای مکان، مانند continent و subcontinent، برای گزارش‌های فهرست پخش کانال جدید پشتیبانی نمی‌شوند.
    • سنجه‌های redViews و estimatedRedMinutesWatched دیگر برای گزارش‌های فهرست پخش کانال جدید پشتیبانی نمی‌شوند. این سنجه‌ها در «استودیوِ YouTube» دردسترس نبوده‌اند، بنابراین این تغییر عملکرد میانای برنامه‌سازی کاربردی را با عملکرد دردسترس در برنامه «استودیو» همسو می‌کند.
    • بعدهای subscribedStatus و youtubeProduct دیگر به‌عنوان فیلتر برای گزارش‌های فهرست پخش کانال پشتیبانی نمی‌شوند. این فیلترها در «استودیوِ YouTube» دردسترس نبوده‌اند، بنابراین این تغییر عملکرد میانای برنامه‌سازی کاربردی را با عملکرد دردسترس در برنامه «استودیو» همسو می‌کند.

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

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

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

  • رفتار سنجه views اکنون به این بستگی دارد که آیا درخواست API که گزارش فهرست پخش را بازیابی کرده است از بُعد isCurated استفاده کرده است یا نه:

    • وقتی درخواستی شامل بُعد isCurated باشد، سنجه views سنجه‌ای درون فهرست پخش است که نشان‌دهنده تعداد دفعاتی است که ویدیوها در زمینه فهرست‌های پخش کانال مشاهده شده‌اند.
    • وقتی درخواستی شامل بُعد isCurated نباشد، سنجه views یک سنجه ویدیویی تجمیع‌شده است که تعداد کل دفعاتی را که ویدیو در فهرست‌های پخش کانال مشاهده شده است مشخص می‌کند، صرف‌نظر از اینکه این بازدیدها در زمینه فهرست پخش انجام شده باشند یا نه. مجموع کل فقط شامل بازدیدهای ویدیوهایی است که متعلق به کانال صاحب فهرست پخش هستند.

      در این گزارش‌ها که از بُعد isCurated استفاده نمی‌کنند، سنجه playlistViews نشان‌دهنده تعداد دفعاتی است که ویدیوها در زمینه فهرست پخش مشاهده شده‌اند. این سنجه بازدیدهای همه ویدیوهای فهرست پخش را می‌شمارد، صرف‌نظر از اینکه کدام کانال مالک آن‌ها است.

  • برای هر گزارش فهرست پخش، اسناد گزارش‌های کانال اکنون شامل جدول��هایی است که سنجه‌های پشتیبانی‌شده برای آن گزارش را بسته به اینکه درخواست API شامل بُعد isCurated باشد یا نه نشان می‌دهد. برای دیدن نمونه، به بخش تعریف گزارش‌های فهرست پخش زمان‌محور مراجعه کنید.

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

‫YouTube Analytics (Targeted Queries) API به‌روز شده است تا دو مقدار بُعد insightTrafficSourceType را ادغام کند. قبلاً، این بُعد بین ویدیوهایی که به‌عنوان بخشی از فهرست پخش پخش می‌شدند (PLAYLIST) و بازدیدهایی که از صفحه‌ای که همه ویدیوهای فهرست پخش را فهرست می‌کند (YT_PLAYLIST_PAGE) تفاوت قائل می‌شد. از این پس، هر دو نوع بازدید با مقدار بُعد PLAYLIST مرتبط خواهند بود.

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

‫YouTube Analytics (Targeted Queries) API از دو بُعد جدید و یک گزارش جدید پشتیبانی می‌کند:

  • گزارش جدیدی فعالیت کاربر را براساس شهر ارائه می‌دهد. این گزارش برای کانال‌ها و مالکان محتوا دردسترس است. این گزارش حاوی بُعد جدید city است که برآورد YouTube از شهری را که فعالیت کاربر در آن انجام شده است شناسایی می‌کند.

  • بُعد جدید creatorContentType نوع محتوای YouTube را که با سنجه‌های فعالیت کاربر در ردیف داده مرتبط است شناسایی می‌کند. مقادیر پشتیبانی‌شده عبارت‌اند از LIVE_STREAM، SHORTS، STORY، و VIDEO_ON_DEMAND.

    بُعد creatorContentType به‌عنوان بُعدی اختیاری برای همه گزارش‌های ویدیویی کانال و مالک محتوا پشتیبانی می‌شود.

  • راهنمای درخواست‌های نمونه YouTube Analytics API اکنون شامل مثال‌هایی برای هر دو بُعد جدید است.

  • ارجاع به ابعاد 7DayTotals و 30DayTotals از اسناد برداشته شده است. منسوخ شدن این ابعاد در اکتبر ۲۰۱۹ اعلام شد.

‫۲۶ اوت ۲۰۲۲

‫YouTube Analytics (Targeted Queries) API و YouTube Reporting (Bulk Reports) API هر دو از مقدار جزئیات منبع ترافیک جدیدی پشتیبانی می‌کنند:

  • در YouTube Analytics API (Targeted Queries) API، اگر مقدار بُعد insightTrafficSourceType SUBSCRIBER باشد، مقدار insightTrafficSourceDetail می‌تواند روی podcasts تنظیم شود که نشان می‌دهد ترافیک از صفحه مقصد «پادکست‌ها» ارجاع داده شده است.
  • در YouTube Reporting (Bulk Reports) API، اگر مقدار بُعد traffic_source_type برابر با 3 باشد، مقدار traffic_source_detail می‌تواند روی podcasts تنظیم شود که نشان می‌دهد ترافیک از صفحه مقصد «پادکست‌ها» ارجاع داده شده است.

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

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

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

  • در YouTube Analytics (Targeted Queries) API، بُعد gender درحال‌حاضر از دو مقدار پشتیبانی می‌کند: female و male. در ۱۱ اوت ۲۰۲۲ یا پس‌از آن، این بُعد از سه مق��ا�� پشتیبانی خواهد کرد: female، male، و user_specified.
  • در YouTube Reporting (Bulk Reports) API، بُعد gender درحال‌حاضر از سه مقدار پشتیبانی می‌کند: FEMALE، MALE، و GENDER_OTHER. در ۱۱ اوت ۲۰۲۲ یا پس‌از آن، مجموعه مقادیر پشتیبانی‌شده به FEMALE، MALE، و USER_SPECIFIED تغییر خواهد کرد.

۹ فوریه ۲۰۲۲

دو سنجه به‌روزرسانی شده‌اند تا ترافیک کلیپ‌های تکرارشونده را از ۱۳ دسامبر ۲۰۲۱ مستثنی کنند. این تغییر هم بر YouTube Analytics (Targeted Queries) API و هم بر YouTube Reporting (Bulk Reports) API تأثیر می‌گذارد.

‫۲ فوریه ۲۰۲۲

این YouTube Reporting (Bulk Reports) API از مقدار بعد منبع ترافیک جدیدی پشتیبانی می‌کند که نشان می‌دهد بازدیدها از هدایت‌های مجدد زنده منشأ گرفته‌اند:

  • در YouTube Reporting (Bulk Reports) API، بُعد traffic_source_type از مقدار 28 پشتیبانی می‌کند.

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

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

‫YouTube Analytics API (پُرسمان‌های هدف‌گیری‌شده) و YouTube Reporting API (گزارش‌های انبوه) هر دو از مقدار بعد منبع ترافیک جدیدی پشتیبانی می‌کنند که نشان می‌دهد بیننده با تند کشیدن عمودی در تجربه مشاهده «کوته‌ویدیوهای YouTube» ارجاع داده شده است:

  • در YouTube Analytics API (پُرسمان‌های هدفمند) API، بُعد insightTrafficSourceType از مقدار SHORTS پشتیبانی می‌کند.
  • در YouTube Reporting (Bulk Reports) API، بُعد traffic_source_type از مقدار 24 پشتیبانی می‌کند.

بُعد جزئیات منبع ترافیک — insightTrafficSourceDetail در YouTube Analytics API یا traffic_source_detail در YouTube Reporting API — برای این نوع منبع ترافیک جدید پُر نشده است.

‫۲۰ ژوئیه ۲۰۲۰ (۳۰ تیر ۱۳۹۹)

این به‌روزرسانی شامل دو تغییر است که بر YouTube Analytics (Targeted Queries) API تأثیر می‌گذارد:

  • حداکثر اندازه گروه گزارش‌دهی YouTube Analytics از ۲۰۰ به ۵۰۰ نهاد افزایش یافته است.
  • پارامتر filters روش reports.query فهرستی از فیلترها را شناسایی می‌کند که باید هنگام بازیابی داده‌های YouTube Analytics اعمال شوند. این پارامتر از توانایی تعیین چند مقدار برای فیلترهای video، playlist، و channel پشتیبانی می‌کند، و حداکثر تعداد شناسه‌هایی که می‌توان برای این فیلترها تعیین کرد از ۲۰۰ به ۵۰۰ شناسه افزایش یافته است.

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

این به‌روزرسانی شامل تغییرات زیر دررابطه‌با YouTube Analytics (پُرسمان‌های هدفمند) API و YouTube Reporting (گزارش‌های انبوه) API است. در مرکز راهنمایی YouTube می‌توانید درباره این تغییرات بیشتر بدانید.

در هر دو API، مجموعه مقادیر جزئیات منبع ترافیک احتمالی برای اعلان‌ها درحال تغییر است. در پُرسمان‌های هدف‌گیری‌شده، اعلان‌ها به‌صورت insightTrafficSourceType=NOTIFICATION گزارش می‌شوند. در گزارش‌های انبوه، اعلان‌ها به‌عنوان traffic_source_type=17 گزارش می‌شوند.

مقادیر جدید اعلان‌های مربوط به ویدیوهای بارگذاری‌شده و جاری‌سازی‌های زنده را که قبلاً به‌عنوان uploaded گزارش می‌شدند به دو دسته تقسیم می‌کنند:

  • uploaded_push - بازدیدهایی که از اعلان‌های لحظه‌ای ارسال‌شده به مشترکان هنگام بارگذاری ویدیو منشأ گرفته‌اند
  • uploaded_other - بازدیدهایی که از اعلان‌های غیرفشاری، مانند اعلان‌های ایمیل یا صندوق ورودی، که هنگام بارگذاری ویدیو به مشترکین ارسال شده‌اند، منشأ گرفته‌اند.

این مقادیر برای محدوده زمانی‌ای که از ۲۰۲۰-۰۱-۱۳ (۱۳ ژانویه ۲۰۲۰) شروع می‌شود برگردانده شده است.

همچنین، به‌عنوان یادآوری، این مقادیر نشان‌دهنده خود اعلان‌ها نیستند، بلکه منابع ترافیکی را نشان می‌دهند که باعث بازدیدهای خاصی در YouTube شده‌اند. برای مثال، اگر ردیف گزارش نشان‌دهنده views=3، traffic_source_type=17 (NOTIFICATION)، و traffic_source_detail=uploaded_push باشد، این ردیف نشان می‌دهد که سه بازدید ناشی از کلیک بینندگان روی اعلان‌های لحظه‌ای ارسال‌شده هنگام بارگذاری ویدیو بوده است.

۱۵ اکتبر ۲۰۱۹

این به‌روزرسانی شامل تغییرات زیر دررابطه‌با YouTube Analytics (Targeted Queries) API است:

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

    ‫YouTube پشتیبانی از ابعاد 7DayTotals و 30DayTotals را حذف می‌کند. تا ۱۵ آوریل ۲۰۲۰ همچنان می‌توانید بااستفاده از آن ابعاد، داده‌ها را بازیابی کنید. در آن تاریخ یا پس‌از آن، تلاش برای بازیابی گزارش‌ها بااستفاده از بُعد 7DayTotals یا 30DayTotals با خطا مواجه خواهد شد.

    توجه داشته باشید که کاربران می‌توانند برخی‌از داده‌های این ابعاد را با پُرسمان بااستفاده از بُعد day و تجمیع یا استخراج داده‌ها در دوره‌های هفت یا ۳۰ روزه بازتولید کنند. برای مثال:

    • تعداد بازدیدها برای یک دوره هفت روزه را می‌توان با جمع کردن تعداد بازدیدهای هر روز از آن دوره محاسبه کرد.
    • viewerPercentage برای یک دوره هفت روزه را می‌توان با ضرب کردن تعداد بازدیدهای هر روز در viewerPercentage آن روز محاسبه کرد تا تعداد بینندگانی که هنگام تماشای ویدیو در آن روز به سیستم وارد شده بودند به‌دست آید. سپس، تعداد بینندگان واردشده به سیستم را می‌توان برای کل دوره اضافه کرد و بر تعداد کل بازدیدها برای آن دوره تقسیم کرد تا viewerPercentage برای کل دوره به‌دست آید.
    • تعداد بینندگان غیرتکراری برای یک دوره هفت روزه قابل محاسبه نیست زیرا ممکن است یک بیننده در روزهای مختلف به‌عنوان بیننده غیرتکراری محاسبه شود. بااین‌حال، ممکن است بتوانید از بُعد month به‌جای بُعد 30DayTotals برای برون‌یابی داده‌های مربوط به تعداد بینندگان غیرتکراری در یک دوره ۳۰ روزه استفاده کنید. توجه داشته باشید که بُعد month به ماه‌های تقویمی اشاره دارد، درحالی‌که بُعد 30DayTotals دوره‌های ۳۰ روزه را براساس تاریخ شروع و پایان مشخص‌شده محاسبه می‌کند.

۲۷ ژوئن ۲۰۱۹

این به‌روزرسانی شامل تغییرات زیر دررابطه‌با YouTube Analytics (Targeted Queries) API است:

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

۱ نوامبر ۲۰۱۸

این به‌روزرسانی شامل تغییرات زیر دررابطه‌با YouTube Analytics (Targeted Queries) API است:

  • نسخه ۱ از API اکنون منسوخ شده است. اگر هنوز این کار را انجام نداده‌اید، لطفاً در اسرع وقت کارخواه‌های میانای برنامه‌سازی کاربردی خود را به‌روز کنید تا از نسخه ۲ میانای برنامه‌سازی کاربردی استفاده کنند و اختلالات سرویس به حداقل برسد. برای جزئیات بیشتر، راهنمای انتقال را ببینید.

    توجه داشته باشید که زمان‌بندی این منسوخ شدن در ابتدا در ۲۶ آوریل ۲۰۱۸ اعلام شده بود.

۱۷ سپتامبر ۲۰۱۸

این به‌روزرسانی شامل تغییرات زیر دررابطه‌با YouTube Analytics (Targeted Queries) API است:

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

    1. یک ویدیو یا کانال در یک دوره زمانی مشخص ترافیک محدودی داشته باشد،

      یا

    2. فیلتر یا بعدی را انتخاب کرده باشید، مثلاً منبع ترافیک یا کشور، که مقادیر به‌ازای آن‌ها به آستانه معین نرسیده است.

    بخش جدید همچنین شامل بحثی درباره انواع داده‌هایی است که ممکن است در گزارش‌های YouTube Analytics محدود شوند.

  • اسناد گزارش‌های کانال و گزارش‌های مالک محتوا به‌روزرسانی شده‌اند تا نشان دهند که سنجه‌های redViews و estimatedRedMinutesWatched دیگر برای گزارش‌های مکان بازپخش، منبع ترافیک، و نوع دستگاه/سیستم‌عامل پشتیبانی نمی‌شوند.

۱۸ ژوئن ۲۰۱۸

این به‌روزرسانی شامل تغییرات زیر در YouTube Analytics (Targeted Queries) API است:

  • الزامات گستره برای روش‌های زیر تغییر کرده است:
    • درخواست‌های ارسال‌شده به روش reports.query باید به دامنه https://www.googleapis.com/auth/youtube.readonly دسترسی داشته باشند.
    • درخواست‌های ارسال‌شده به روش groupItems.list باید به یکی از موارد زیر دسترسی داشته باشند:
      • https://www.googleapis.com/auth/youtube scope
        or
      • حوزه https://www.googleapis.com/auth/youtube.readonly
        و
        حوزه https://www.googleapis.com/auth/yt-analytics.readonly

      گزینه اول از یک دامنه استفاده می‌کند که اتفاقاً دامنه خواندن-نوشتن است، درحالی‌که گزینه دوم از دو دامنه فقط خواندنی استفاده می‌کند.

۲۳ مه ۲۰۱۸

این به‌روزرسانی شامل تغییرات زیر در YouTube Analytics (Targeted Queries) API است:

  • «نمای کلی API» حاوی بخش جدیدی با عنوان سنجه‌های انبوهشی و موارد حذف‌شده است که توضیح می‌دهد پاسخ‌های API چگونه داده‌های مرتبط با منابع حذف‌شده، مانند ویدیوها، فهرست‌های پخش، یا کانال‌ها را مدیریت می‌کنند.
  • بخش روال‌های مطلوب در «نمای کلی میانای برنامه‌سازی کاربردی» به‌روزرسانی شده است تا به شما یادآوری کند که می‌توانید از YouTube Data API برای بازیابی فراداده‌های اضافی برای منابع شناسایی‌شده در پاسخ‌های «میانای برنامه‌سازی کاربردی YouTube Analytics» استفاده کنید. همان‌طور که در خط‌مشی‌های توسعه‌دهندگان سرویس‌های YouTube API (بخش‌های III.E.4.b تا III.E.4.d) ذکر شده است، کارخواه‌های میانای برنامه‌سازی کاربردی باید فراداده منبع ذخیره‌شده از آن میانای برنامه‌سازی کاربردی را پس‌از ۳۰ روز حذف یا بازآوری کنند.

۲۲ مه ۲۰۱۸

این به‌روزرسانی حاوی تغییرات زیر دررابطه‌با YouTube Reporting (Bulk Reports) API است:

  • تغییرات زیر درحال‌حاضر برای اجرا در ژوئیه ۲۰۱۸ برنامه‌ریزی شده‌اند و خط‌مشی‌های جدید به‌طور جهانی برای همه گزارش‌ها و کارهای گزارش‌دهی اعمال می‌شوند.

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

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

    • پس‌از این تغییر، وقتی کار گزارش‌دهی را زمان‌بندی می‌کنید، YouTube گزارش‌ها را از آن روز به بعد و برای دوره ۳۰ روزه قبل‌از زمان زمان‌بندی کار تولید خواهد کرد. پیش‌از این تغییر، وقتی کار گزارش‌دهی را زمان‌بندی می‌کنید، YouTube گزارش‌هایی را تولید می‌کند که دوره ۱۸۰ روزه قبل‌از زمان زمان‌بندی کار را پوشش می‌دهد.

  • بخش روال‌های مطلوب به‌روزرسانی شده است تا به شما یادآوری کند که می‌توانید از YouTube Data API برای بازیابی فراداده‌های اضافی برای منابع شناسایی‌شده در گزارش‌ها استفاده کنید. همان‌طور که در خط‌مشی‌های توسعه‌دهندگان سرویس‌های YouTube API (بخش‌های III.E.4.b تا III.E.4.d) ذکر شده است، کارخواه‌های میانای برنامه‌سازی کاربردی باید فراداده منبع ذخیره‌شده از آن میانای برنامه‌سازی کاربردی را پس‌از ۳۰ روز حذف یا بازآوری کنند.

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

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

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

۲۶ آوریل ۲۰۱۸

نسخه ۲ YouTube Analytics (پُرسمان‌های هدف‌گیری‌شده) API (v2) اکنون به‌صورت عمومی دردسترس است. فهرست زیر تغییرات محصول و مستندات مربوط به نسخه جدید API را مشخص می‌کند:

  • «میانای برنامه‌سازی کاربردی» نسخه v2 تقریباً مشابه «میانای برنامه‌سازی کاربردی» نسخه v1 است. اما احتمالاً باید کدتان را به‌روز کنید تا تغییرات فهرست‌شده در زیر اعمال شود. همه این تغییرات به‌طور مفصل در راهنمای انتقال جدید توضیح داده شده است.

    • نسخه API از v1 به v2 تغییر کرده است.
    • نشانی وب پایه برای درخواست‌های API از https://www.googleapis.com/youtube/analytics/v1 به https://youtubeanalytics.googleapis.com/v2 تغییر کرده است.
    • نام چند پارامتر برای روش reports.query به‌روز شده است. به‌طور خاص، نام‌های پارامتر حاوی خط تیره، مانند end-date در «میانای برنامه‌سازی کاربردی» نسخه v1، در «میانای برنامه‌سازی کاربردی» نسخه v2 به‌جای خط تیره از نگارش شتری (endDate) استفاده می‌کنند. این تغییر باعث می‌شود نام پارامترها در سراسر میانای برنامه‌سازی کاربردی یکسان باشد، زیرا روش‌های میانای برنامه‌سازی کاربردی برای ایجاد و مدیریت گروه‌ها ازقبل از نگارش شتری برای نام پارامترها استفاده می‌کردند.
    • میانای برنامه‌سازی کاربردی نسخه ۲ از درخواست‌های دسته‌ای ارسال‌شده به نقطه پایانی دسته‌ای HTTP جهانی Google (www.googleapis.com/batch) پشتیبانی نمی‌کند. اگر درخواست‌های دسته‌ای را در میانای برنامه‌سازی کاربردی نسخه ۲ ارسال می‌کنید، باید به‌جای آن از نقطه پایانی https://youtubeanalytics.googleapis.com/v2 استفاده کنید.

    علاوه‌براین، چند ویژگی نسخه ۱ در میانای برنامه‌سازی کاربردی نسخه ۲ پشتیبانی نمی‌شود:

    • روش reports.query دیگر از پارامترهای درخواست alt، quotaUser، و userIp پشتیبانی نمی‌کند.
    • «میانای برنامه‌سازی کاربردی» نسخه v2 نقطه پایانی دسته‌ای ارائه نمی‌دهد که از دسته‌های متشکل از درخواست‌ها به «میاناهای برنامه‌سازی کاربردی» مختلف پشتیبانی کند. (بااین‌حال، یک دسته می‌تواند شامل درخواست‌هایی برای روش‌های مختلف یک میانای برنامه‌سازی کاربردی باشد.) این منسوخ شدن مختص YouTube Analytics API نیست، زیرا Google درحال منسوخ کردن نقطه پایانی دسته‌ای جهانی در همه APIهای خود است.
    • «میانای برنامه‌سازی کاربردی» نسخه v2 از پروتکل JSON-RPC که در «میانای برنامه‌سازی کاربردی» نسخه v1 پشتیبانی می‌شد پشتیبانی نمی‌کند. مجدداً، این منسوخ شدن مختص YouTube Analytics API نیست.

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

    نسخه ۱ میانای برنامه‌سازی کاربردی (v1) اکنون منسوخ شده است و تا ۳۱ اکتبر ۲۰۱۸ پشتیبانی خواهد شد. پس‌از آن تاریخ، همه درخواست‌ها به «میانای برنامه‌سازی کاربردی» نسخه v1 ازکار خواهند افتاد. بنابراین، لطفاً حتماً حداکثر تا ۳۱ اکتبر ۲۰۱۸ به نسخه ۲ میانای برنامه‌سازی کاربردی ارتقا دهید تا از هرگونه وقفه در توانایی شما برای دسترسی به داده‌های YouTube Analytics ازطریق میانای برنامه‌سازی کاربردی جلوگیری شود.

۲۱ فوریه ۲۰۱۸

این به‌روزرسانی شامل تغییرات زیر در YouTube Analytics (Targeted Queries) API است:

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

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

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

  • YouTube Reporting API (Bulk Reports)

    • بُعد operating_system که سیستم نرم‌افزار دستگاهی را که بازدیدها در آن انجام شده است شناسایی می‌کند، اکنون از مقدار زیر پشتیبانی می‌کند:
      • ‫25: KaiOS

  • YouTube Analytics API (Targeted Queries)

    • بُعد operatingSystem از مقدار بُعد KAIOS پشتیبانی می‌کند.

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

این به‌روزرسانی شامل دو تغییر مربوط به YouTube Reporting API است:

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

    برای دریافت پاسخ کدگذاری‌شده با gzip، سرایند درخواست HTTP Accept-Encoding را روی gzip تنظیم کنید، همان‌طور که در مثال زیر نشان داده شده است:

    Accept-Encoding: gzip

    این عملکرد در نمای کلی API و در تعریف ویژگی downloadUrl منبع report توضیح داده شده است.

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

    • مقادیر بُعد age_group از حروف بزرگ استفاده می‌کنند، بین کلمه AGE و اعداد در گروه سنی زیرخط دارند، و به‌جای خط تیره از زیرخط استفاده می‌کنند. به همین دلیل، مقادیری مثل age13-17 و age18-24 به‌ترتیب به AGE_13_17 و AGE_18_24 اصلاح شده‌اند.
    • مقادیر بُعد gender از حروف بزرگ استفاده می‌کنند. بنابراین، مقادیر female، male، و gender_other به FEMALE، MALE، و GENDER_OTHER اصلاح شده‌اند.

۱۰ اوت ۲۰۱۷

در ۱۰ اوت ۲۰۱۶، این سند منسوخ شدن سنجه earnings در YouTube Analytics API را اعلام کرد. (هم‌زمان، این میانای برنامه‌سازی کاربردی پشتیبانی از سنجه جدیدی به‌نام estimatedRevenue را اضافه کرد که همان داده‌ها را ارائه می‌دهد.)

ازآنجایی‌که سنجه earnings سنجه‌ای اصلی بود، به‌مدت یک سال از تاریخ اعلام پشتیبانی شد. اما اکنون که آن دوره یک‌ساله به‌پایان رسیده است، سنجه earnings دیگر پشتیبانی نمی‌شود. درنتیجه، درخواست‌های API که سنجه earnings را مشخص می‌کنند اکنون کد پاسخ HTTP 400 را برمی‌گردانند. اگر هنوز برنامه‌تان را برای استفاده از سنجه estimatedRevenue به‌جای سنجه earnings به‌روز نکرده‌اید، لطفاً در اسرع وقت این کار را انجام دهید.

اسناد API به‌روز شده است تا ارجاع‌های باقی‌مانده به سنجه earnings برداشته شود.

۶ ژوئیه ۲۰۱۷

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

  • YouTube Analytics API (Targeted Queries)

    • اسناد میانای برنامه‌سازی کاربردی به‌روزرسانی شده است تا این واقعیت را نشان دهد که پاسخ‌های میانای برنامه‌سازی کاربردی حاوی داده‌هایی تا آخرین روز در محدوده تاریخ درخواستی است که همه سنجه‌های مورد پُرسمان برای آن دردسترس است.

      برای مثال، اگر در درخواستی تاریخ پایان ۵ ژوئیه ۲۰۱۷ مشخص شده باشد و مقادیر همه سنجه‌های درخواستی فقط تا ۳ ژوئیه ۲۰۱۷ دردسترس باشد، آن تاریخ آخرین تاریخی خواهد بود که داده‌های آن در پاسخ گنجانده می‌شود. (این موضوع حتی درصورتی‌که داده‌های برخی‌از سنجه‌های درخواستی برای ۴ ژوئیه ۲۰۱۷ دردسترس باشد نی�� ��اد�� است.)

    • بُعد adType اکنون از مقدار reservedBumperInstream پشتیبانی می‌کند که به آگهی ویدیویی ردنشدنی تا ۶ ثانیه اشاره دارد که قبل‌از تماشای ویدیو پخش می‌شود. قالب آگهی با آگهی auctionBumperInstream یکسان است، اما این نوع به آگهی‌هایی اشاره دارد که بر اساس رزرو فروخته می‌شوند، نه بر اساس مزایده.

  • YouTube Reporting API (Bulk Reports)

    • بُعد ad_type اکنون از مقدار 20 پشتیبانی می‌کند که به آگهی‌های بامپر فروخته‌شده به‌صورت رزروشده اشاره دارد. آگهی‌های بامپر آگهی‌های ویدیویی ردنشدنی تا ۶ ثانیه هستند که قبل‌از تماشای ویدیو پخش می‌شوند. توجه داشته باشید که مقدار 19 برای این بُعد به آگهی‌های ضربه‌ای نیز اشاره دارد که به‌جای مبنای رزروشده، در مزایده فروخته می‌شوند.

    • کارهای گزارش‌دهی برای گزارش‌های YouTube Reporting API زیر حذف شده‌اند:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      این انواع گزارش در ۱۵ سپتامبر ۲۰۱۶ به‌عنوان منسوخ اعلام شدند و پس‌از ۱۵ دسامبر ۲۰۱۶ دیگر گزارشی برای این انواع گزارش تولید نشد. گزارش‌هایی که قبلاً تولید شده‌اند همچنان به‌مدت ۱۸۰ روز از زمان تولید دردسترس خواهند بود. بنابراین، برخی‌از گزارش‌ها تا ۱۵ ژوئن ۲۰۱۷ قابل‌دسترسی بودند. اما چون گزارش‌ها دیگر دردسترس نیستند، کارهای مرتبط با گزارش‌ها نیز موردنیاز نیستند.

۲۴ مه ۲۰۱۷

همه کارهای گزارش‌دهی برای گزارش‌های YouTube Reporting API زیر حذف شده‌اند:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

این نوع گزارش‌ها در ۲۲ ژوئن ۲۰۱۶ به‌عنوان منسوخ اعلام شدند و پس‌از ۲۲ سپتامبر ۲۰۱۶ دیگر برای این نوع گزارش‌ها گزارشی تولید نشد. گزارش‌هایی که قبلاً تولید شده‌اند همچنان به‌مدت ۱۸۰ روز از زمان تولید دردسترس خواهند بود. بنابراین، برخی‌از گزارش‌ها تا ۲۲ مارس ۲۰۱۷ قابل‌دسترسی بودند. اما چون گزارش‌ها دیگر دردسترس نیستند، کارهای مرتبط با گزارش‌ها نیز موردنیاز نیستند.

۲۲ مه ۲۰۱۷

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

  • YouTube Reporting API (Bulk Reports)

    • بُعد sharing_service که سرویس مورداستفاده برای هم‌رسانی ویدیوها را شناسایی می‌کند، اکنون از مقادیر زیر پشتیبانی می‌کند:
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      علاوه‌براین، نامی که برای شناسایی مقدار 52 استفاده می‌شود در اسناد به Kakao (Kakao Talk) به‌روز شده است تا به‌طور واضح‌تری از مقدار 73 (Kakao Story) متمایز شود. این تغییر نشان‌دهنده هیچ تغییری در رفتار میانای برنامه‌سازی کاربردی یا طبقه‌بندی ویدیوهای هم‌رسانی‌شده با این سرویس‌ها نیست.

  • YouTube Analytics API (Targeted Queries)

    • بُعد sharingService اکنون از مقادیر زیر پشتیبانی می‌کند:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

‫۲۸ مارس ۲۰۱۷

صاحبان کانال که می‌توانند ازطریق YouTube Analytics در «استودیوِ محتواساز» به داده‌های درآمد دسترسی داشته باشند، اکنون می‌توانند ازطریق YouTube Analytics API نیز به آن داده‌های درآمد دسترسی داشته باشند:

‫۱۷ مارس ۲۰۱۷

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

  • ‫YouTube Analytics API از سنجه‌های redViews و estimatedRedMinutesWatched پشتیبانی می‌کند که هر دو به تعداد بینندگان YouTube Red مربوط می‌شوند. درواقع، API مدتی است که از این سنجه‌ها پشتیبانی می‌کند و YouTube Reporting API نیز همان‌طور که در ۱۵ سپتامبر ۲۰۱۶ اعلام شد، از هر دو سنجه پشتیبانی می‌کند.

    • سنجه redViews تعداد دفعاتی را که ویدیو توسط اعضای YouTube Red مشاهده شده است شناسایی می‌کند.
    • سنجه estimatedRedMinutesWatched تعداد دقیقه‌هایی را که اعضای YouTube Red ویدیو را تماشا کرده‌اند مشخص می‌کند.

    اسناد گزارش‌های کانال و گزارش‌های مالک محتوا به‌روزرسانی شده‌اند تا نشان دهند کدام گزارش‌ها از دو سنجه جدید پشتیبانی می‌کنند. این کمپین‌ها در هر گزارشی که ازقبل از سنجه‌های views و estimatedMinutesWatched پشتیبانی می‌کرد پشتیبانی می‌شوند.

۳ مارس ۲۰۱۷

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

  • YouTube Reporting API (Bulk Reports)

    • تعریف بُعد date اصلاح شده است تا مشخص شود که مقدار بُعد به دوره‌ای ��شاره دارد که ��ز ��ا��ت ����:۰۰ بامداد به وقت اقیانوس آرام شروع می‌شود و در ساعت ۱۱:۵۹ شب به وقت اقیانوس آرام در روز، ماه، و سال مشخص‌شده پایان می‌یابد. بسته به زمان سال، زمان اقیانوس آرام UTC-7 یا UTC-8 است.

      اگرچه تاریخ‌ها معمولاً نشان‌دهنده یک دوره ۲۴ ساعته هستند، تاریخ‌هایی که ساعت‌ها به جلو تنظیم می‌شوند نشان‌دهنده یک دوره ۲۳ ساعته هستند و تاریخ‌هایی که ساعت‌ها به عقب تنظیم می‌شوند نشان‌دهنده یک دوره ۲۵ ساعته هستند. (قبلاً در اسناد ذکر شده بود که هر تاریخ نشان‌دهنده یک دوره ۲۴ ساعته منحصربه‌فرد است و زمان اقیانوس آرام همیشه UTC-8 است.)

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

    • بُعد operating_system که سیستم نرم‌افزار دستگاهی را که بازدیدها در آن انجام شده است شناسایی می‌کند، اکنون از مقادیر زیر پشتیبانی می‌کند:
      • ‫22: Tizen
      • ‫23: Firefox
      • ‫24: RealMedia

    • همه کارهای گزارش‌دهی برای نوع گزارش content_owner_basic_a1 حذف شده‌اند. آن نوع گزارش از ۱۹ اوت ۲۰۱۶ کاملاً منسوخ شده بود، اما گزارش‌های content_owner_basic_a1 که قبلاً تولید شده بودند همچنان تا ۱۸۰ روز پس‌از زمان تولید دردسترس بودند. بنابراین، برخی‌از گزارش‌ها تا ۱۹ فوریه ۲۰۱۷ قابل‌دسترسی بودند. اما چون گزارش‌ها دیگر دردسترس نیستند، کارهای مرتبط با گزارش‌ها نیز موردنیاز نیستند.

  • YouTube Analytics API (Targeted Queries)

    • شرح ابعاد مربوط به time periods اصلاح شده است تا مشخص شود که مقدار بعد به دوره‌ای اشاره دارد که از ساعت ۱۲:۰۰ بامداد به وقت اقیانوس آرام شروع می‌شود و در ساعت ۱۱:۵۹ بعدازظهر به وقت اقیانوس آرام در روز، ماه، و سال مشخص‌شده پایان می‌یابد. بسته به زمان سال، زمان اقیانوس آرام UTC-7 یا UTC-8 است.

      اگرچه تاریخ‌ها معمولاً نشان‌دهنده یک دوره ۲۴ ساعته هستند، تاریخ‌هایی که ساعت‌ها به جلو تنظیم می‌شوند نشان‌دهنده یک دوره ۲۳ ساعته هستند و تاریخ‌هایی که ساعت‌ها به عقب تنظیم می‌شوند نشان‌دهنده یک دوره ۲۵ ساعته هستند. (قبلاً در اسناد ذکر شده بود که زمان اقیانوس آرام UTC-8 است و به این احتمال که ممکن است یک روز نشان‌دهنده یک دوره ۲۴ ساعته نباشد اشاره نشده بود.)

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

    • اسناد گزارش‌های کانال به‌روزرسانی شده‌اند تا نشان دهند که گزارش‌های کانال درحال‌حاضر شامل سنجه‌های درآمد یا عملکرد آگهی نیستند. درنتیجه، درحال‌حاضر دامنه https://www.googleapis.com/auth/yt-analytics-monetary.readonly دسترسی به داده‌های پولی را در گزارش‌های کانال اعطا نمی‌کند.

    • بُعد operatingSystem از سه مقدار بُعد جدید پشتیبانی می‌کند:
      • FIREFOX
      • REALMEDIA
      • TIZEN

۸ فوریه ۲۰۱۷

‫YouTube Analytics API اکنون از پارامتر اختیاری include-historical-channel-data پشتیبانی می‌کند. توجه داشته باشید که این پارامتر فقط هنگام بازیابی گزارش‌های مالک محتوا مرتبط است.

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

این قوانین همچنین درصورتی اعمال می‌شوند که درخواست API داده‌ها را برای چندین کانال بازیابی کند:

  • اگر مقدار پارامتر false باشد، داده‌های زمان تماشا و بازدیدهای برگردانده‌شده برای هر کانال مشخص براساس تاریخی است که آن کانال به مالک محتوا پیوند داده شده است.

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

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

گزارش‌های YouTube Reporting API زیر دیگر پشتیبانی نمی‌شوند و از اسناد حذف شده‌اند. نسخه جدیدتری از هر گزارش دردسترس است. (اعلامیه منسوخ شدن این گزارش‌ها در ۱۵ سپتامبر ۲۰۱۶ منتشر شد.)

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

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

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

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

  • گزارش‌های صفحه پایانی

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

  • ابعاد صفحه پایانی

    • end_screen_element_type: نوع عنصر صفحه پایانی مرتبط با آمار.
    • end_screen_element_id: شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد عنصر صفحه پایانی استفاده می‌کند.

  • سنجه‌های صفحه پایانی

    توجه: داده‌های سنجه‌های صفحه پایانی از ۱ مه ۲۰۱۶ دردسترس است.

    • ‫end_screen_element_impressions: تعداد کل ظهورهای عنصر صفحه پایانی. یک ظهور برای هر عنصر صفحه پایانی که نمایش داده می‌شود ثبت می‌شود.
    • end_screen_element_clicks: تعداد دفعاتی که روی عناصر صفحه پایانی کلیک شده است.
    • end_screen_element_click_rate: نرخ کلیک‌گذری برای عناصر صفحه پایانی.

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

  • گزارش‌های زیر دیگر پشتیبانی نمی‌شوند و از اسناد برداشته شده‌اند. نسخه جدیدتری از هر گزارش دردسترس است. (اعلامیه منسوخ شدن این گزارش‌ها در ۲۲ ژوئن ۲۰۱۶ منتشر شد.)

۸ نوامبر ۲۰۱۶

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

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

    سنجه منسوخ‌شده سنجه جدید
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

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

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

نمای کلی گزارش‌های مدیریت‌شده توسط سیستم نمای کلی مختصری از گزارش‌های جدید ارائه می‌دهد و فرایند بازیابی آن‌ها را ازطریق API توضیح می‌دهد. این فرایند کمی با فرایند بازیابی گزارش‌های انبوه برای YouTube Analytics متفاوت است زیرا شرکا برای تولید گزارش‌ها نیازی به زمان‌بندی کارها ندارند.

ویژگی id منبع reportType به‌روزرسانی شده است تا شامل فهرستی از گزارش‌های مدیریت‌شده توسط سیستم باشد که می‌توانید ازطریق میانای برنامه‌سازی کاربردی به آن‌ها دسترسی داشته باشید:

  • درآمد آگهی ماهانه جهانی به‌ازای هر ویدیو
  • درآمد آگهی روزانه به‌ازای هر کشور برای هر ویدیو
  • درآمد آگهی ماهانه جهانی به‌ازای هر دارایی
  • درآمد آگهی روزانه به‌ازای هر دارایی برای هر کشور
  • ادعاها (این گزارش شامل داده‌های درآمد نمی‌شود)

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

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

سنجه uniques در YouTube Analytics API منسوخ شده است. این سنجه اصلی نیست و تا ۳۱ اکتبر ۲۰۱۶ پشتیبانی خواهد شد.

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

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

  • این API از دو سنجه جدید مربوط به بینندگان YouTube Red پشتیبانی می‌کند:

    • red_views: تعداد دفعاتی که ویدیو توسط اعضای YouTube Red مشاهده شده است.
    • red_watch_time_minutes: تعداد دقیقه‌هایی که اعضای YouTube Red ویدیو را تماشا کرده‌اند.

  • این API از نسخه‌های جدید ۲۰ گزارش پشتیبانی می‌کند. همه نسخه‌های جدید از سنجه‌های جدید red_views و red_watch_time_minutes پشتیبانی می‌کنند.

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

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

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

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

    • channel_basic_a1
    • channel_province_a1
    • channel_playback_location_a1
    • channel_traffic_source_a1
    • channel_device_os_a1
    • channel_subtitles_a1
    • channel_combined_a1
    • content_owner_basic_a2
    • content_owner_province_a1
    • content_owner_playback_location_a1
    • content_owner_traffic_source_a1
    • content_owner_device_os_a1
    • content_owner_subtitles_a1
    • content_owner_combined_a1
    • content_owner_asset_basic_a1
    • content_owner_asset_province_a1
    • content_owner_asset_playback_location_a1
    • content_owner_asset_traffic_source_a1
    • content_owner_asset_device_os_a1
    • content_owner_asset_combined_a1

    اگر برای هریک از این گزارش‌ها کار دارید، نباید انتظار داشته باشید که YouTube پس‌از ۱۵ دسامبر ۲۰۱۶ گزارش‌های جدیدی برای این کارها تولید کند. گزارش‌های تولیدشده همچنان به‌مدت ۱۸۰ روز از زمان تولید دردسترس خواهند بود.

‫۱۹ اوت ۲۰۱۶

این به‌روزرسانی حاوی تغییرات زیر در YouTube Reporting API است:

  • گزارش content_owner_basic_a1 کاملاً منسوخ شده و از اسناد حذف شده است. YouTube دیگر گزارش‌های جدیدی از آن نوع تولید نخواهد کرد، هرچند گزارش‌هایی که قبلاً تولید شده‌اند همچنان تا ۱۸۰ روز پس‌از زمان تولید دردسترس خواهند بود.

    همان‌طور که در ورودی سابقه ویرایش برای ۱۹ مه ۲۰۱۶ توضیح داده شده است، گزارش content_owner_basic_a2 جایگزین گزارش content_owner_basic_a1 شده است.

۱۱ اوت ۲۰۱۶

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

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

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

‫۱۰ اوت ۲۰۱۶

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

  • YouTube Analytics API (Targeted Queries)

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

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

      نام سنجه قدیمی نام سنجه جدید تاریخ پشتیبانی
      earnings estimatedRevenue ۱۰ اوت ۲۰۱۷
      adEarnings estimatedAdRevenue ۴ نوامبر ۲۰۱۶
      redPartnerRevenue estimatedRedPartnerRevenue ۴ نوامبر ۲۰۱۶
      impressionBasedCpm cpm ۴ نوامبر ۲۰۱۶
      impressions adImpressions ۴ نوامبر ۲۰۱۶

      توجه داشته باشید که سنجه earnings یک سنجه اصلی بود، بنابراین تا یک سال از تاریخ این اعلامیه پشتیبانی خواهد شد. سایر سنجه‌ها که سنجه‌های اصلی نبودند، به‌مدت سه ماه تا ۴ نوامبر ۲۰۱۶ پشتیبانی خواهند شد.

      برای مثال، تا ۴ نوامبر ۲۰۱۶، درخواست API می‌تواند سنجه impressionBasedCpm، سنجه cpm، یا هر دو را مشخص کند. اما پس‌از آن تاریخ، فقط سنجه cpm پشتیبانی خواهد شد.

    • بُعد insightTrafficSourceType از دو مقدار بُعد جدید پشتیبانی می‌کند:
      • CAMPAIGN_CARD: این منبع ترافیک فقط برای گزارش‌های مالک محتوا پشتیبانی می‌شود. این نشان می‌دهد که بازدیدها از ویدیوهای بارگذاری‌شده توسط کاربر که ادعا شده‌اند و مالک محتوا برای تبلیغ محتوای مشاهده‌شده استفاده کرده است، منشأ گرفته‌اند.
      • END_SCREEN: داده‌ها مربوط به بازدیدهایی است که از صفحه پایانی ویدیو دیگری منشأ گرفته‌اند.

      برای هر دو منبع ترافیک جدید، می‌توانید گزارش traffic source detail را نیز بازیابی کنید. در هر دو مورد، بُعد insightTrafficSourceDetail ویدیویی را که بیننده از آن ارجاع داده شده است شناسایی می‌کند.

    • بُعد adType اکنون از مقدار auctionBumperInstream پشتیبانی می‌کند که به آگهی ویدیویی ردنشدنی تا ۶ ثانیه اشاره دارد که قبل‌از تماشای ویدیو پخش می‌شود.

  • YouTube Reporting API (Bulk Reports)

    • بُعد traffic_source_type اکنون از مقادیر زیر پشتیبانی می‌کند:
      • 19: این منبع ترافیک فقط برای گزارش‌های مالک محتوا پشتیبانی می‌شود. این نشان می‌دهد که بازدیدها از ویدیوهای بارگذاری‌شده توسط کاربر که ادعا شده‌اند و مالک محتوا برای تبلیغ محتوای مشاهده‌شده استفاده کرده است، منشأ گرفته‌اند.
      • 20: داده‌ها مربوط به بازدیدهایی است که از صفحه پایانی ویدیو دیگری منشأ گرفته‌اند.

      برای هر دو منبع ترافیک جدید، بُعد traffic_source_detail ویدیویی را که بیننده از آن ارجاع داده شده است شناسایی می‌کند.

    • فهرست سنجه‌های اصلی API اصلاح شده است تا estimated_partner_revenue به‌عنوان سنجه اصلی فهرست شود و earnings از آن فهرست برداشته شود. (سنجه earnings هرگز در YouTube Reporting API پشتیبانی نشده است.)

    • بُعد ad_type اکنون از مقدار 19 پشتیبانی می‌کند که به آگهی‌های خطی کوتاه اشاره دارد. این آگهی‌ها آگهی‌های ویدیویی ردنشدنی تا ۶ ثانیه هستند که قبل‌از تماشای ویدیو پخش می‌شوند.

۱۸ ژوئیه ۲۰۱۶

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

  • YouTube Analytics API (Targeted Queries)

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

    • فهرست فیلترها هم برای گزارش‌های حفظ مخاطب کانال و هم برای گزارش‌های حفظ مخاطب مالک محتوا اصلاح شده است تا نشان دهد که فیلتر video الزامی است و فیلتر group پشتیبانی نمی‌شود.

      قبلاً، در اسناد هر دو گزارش به‌اشتباه ذکر شده بود که گزارش را می‌توان بااستفاده از یکی از این دو فیلتر یا بدون استفاده از هیچ‌کدام از این فیلترها بازیابی کرد.

  • YouTube Reporting API (Bulk Reports)

    • در نمای کلی API، بخشی که نحوه بازیابی نشانی وب بارگیری گزارش را توضیح می‌دهد اصلاح شده است تا بیان کند که YouTube گزارش‌های قابل‌بارگیری را برای روزهایی که هیچ داده‌ای دردسترس نبوده است تولید می‌کند. این گزارش‌ها حاوی ردیف سرصفحه هستند اما داده‌های اضافی ندا��ند. این اطلاعات قبلاً در بخش ویژگی‌های گزارش همان سند در ۱۲ آوریل ۲۰۱۶ به‌روز شده بود.
    • فهرست ابعاد در گزارش content_owner_asset_cards_a1 اصلاح شده است تا نشان دهد که گزارش از بُعد card_id استفاده می‌کند. قبلاً، در اسناد نام بُعد به‌اشتباه card_title ذکر شده بود.

‫۲۸ ژوئن ۲۰۱۶

اسناد YouTube Analytics API به‌روزرسانی شده است تا پشتیبانی از سنجه‌های کارت را در گزارش‌های متعدد کانال و مالک محتوا نشان دهد. سنجه‌هایی که به‌تازگی پشتیبانی می‌شوند عبارت‌اند از:

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

‫۲۲ ژوئن ۲۰۱۶

این به‌روزرسانی شامل تغییرات زیر در YouTube Reporting API است. تغییر اول مربوط به API به‌طور کلی است و تغییرات باقی‌مانده فقط بر گزارش‌های مالک محتوا تأثیر می‌گذارد:

  • بخش ویژگی‌های گزارش در نمای کلی میانای برنامه‌سازی کاربردی به‌روزرسانی شده است تا شفاف‌سازی شود که گزارش‌ها ازطریق میانای برنامه‌سازی کاربردی به‌مدت ۱۸۰ روز از زمان تولید دردسترس هستند.

    قبلاً در اسناد ذکر شده بود که گزارش‌ها برای دوره‌ای حداکثر ۱۸۰ روزه قبل‌از تاریخ ارسال درخواست API دردسترس هستند. اگرچه ازنظر فنی درست است، اما نوشتار اصلی در بهترین حالت نسبتاً گیج‌کننده بود.

  • این API از نسخه‌های جدید سه گزارش پشتیبانی می‌کند. دو مورد از این گزارش‌ها همچنین حاوی سنجه‌های جدید و تغییرنام‌یافته هستند:

    • گزارش content_owner_ad_rates_a1 نسخه جدید گزارش content_owner_ad_performance_a1 است. گزارشی که به‌تازگی نام آن تغییر کرده است با نسخه قبلی یکسان است.

    • دو گزارش که نسخه‌های جدیدی دارند تغییر نام داده‌اند:

      • نام نسخه جدید گزارش content_owner_estimated_earnings_a1، content_owner_estimated_revenue_a1 است.
      • نام نسخه جدید گزارش content_owner_asset_estimated_earnings_a1، content_owner_asset_estimated_revenue_a1 است.

      هر دو گزارش جدیداً تغییرنام‌یافته از جهات زیر با گزارش‌های قبلی خود تفاوت دارند:

      • آن‌ها سنجه جدید estimated_partner_red_revenue را اضافه می‌کنند که کل درآمد خالص از اشتراک‌های YouTube Red را تخمین می‌زند.
      • آن‌ها سنجه جدید estimated_partner_transaction_revenue را اضافه می‌کنند که درآمد حاصل از تراکنش‌ها، مانند محتوای پولی و «تأمین بودجه از طرفداران»، را با کسر هرگونه بازپرداخت کسرشده از شریک تخمین می‌زند.
      • نام سنجه estimated_partner_ad_sense_revenue را به estimated_partner_ad_auction_revenue تغییر می‌دهند.
      • نام سنجه estimated_partner_double_click_revenue را به estimated_partner_ad_reserved_revenue تغییر می‌دهند.

    توجه داشته باشید که اگر ازقبل کارهایی برای ایجاد هرکدام از نسخه‌های قدیمی‌تر این گزارش‌ها دارید، باید کارهای جدیدی برای گزارش‌های تغییرنام‌یافته ایجاد کنید. هم‌زمان با انتشار نسخه‌های جدید گزارش، گزارش‌های content_owner_ad_performance_a1، content_owner_estimated_earnings_a1، و content_owner_asset_estimated_earnings_a1 منسوخ شده‌اند.

    اگر برای هریک از این گزارش‌ها کاری دارید، نباید انتظار داشته باشید که YouTube پس‌از ۲۲ سپتامبر ۲۰۱۶ گزارش‌های جدیدی برای آن کارها تولید کند. گزارش‌های تولیدشده همچنان به‌مدت ۱۸۰ روز از زمان تولید دردسترس خواهند بود.

  • تعریف ویژگی id منبع reportType به‌روز شده است تا مجموعه فعلی گزارش‌های دردسترس را منعکس کند.

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

    • نام سنجه estimated_partner_adsense_revenue به estimated_partner_ad_sense_revenue به‌روزرسانی شده است. اما توجه داشته باشید که این سنجه فقط در دو گزارش نشان داده می‌شود که با این به‌روزرسانی منسوخ می‌شوند. همان‌طور که در بالا توضیح داده شد، نام این سنجه در نسخه‌های جدیدتر آن گزارش‌ها به estimated_partner_ad_auction_revenue تغییر کرده است.
    • نام سنجه estimated_partner_doubleclick_revenue به estimated_partner_double_click_revenue به‌روزرسانی شده است. مجدداً توجه داشته باشید که این سنجه فقط در دو گزارشی نشان داده می‌شود که با این به‌روزرسانی منسوخ می‌شوند. همان‌طور که در بالا توضیح داده شد، این سنجه در نسخه‌های جدیدتر آن گزارش‌ها به estimated_partner_ad_reserved_revenue تغییر نام داده است.

  • سند ابعاد برای Reporting API به‌روزرسانی شده است تا دیگر ویژگی‌های elapsed_video_time_percentage و audience_retention_type را فهرست نکند. این ابعاد درحال‌حاضر توسط هیچ گزارشی که ازطریق API دردسترس باشد پشتیبانی نمی‌شود.

‫۱۹ مه ۲۰۱۶

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

  • این API از نسخه جدید گزارش فعالیت کاربر برای ما��کان محتوا پشتیبانی می‌کند. شناسه نوع گزارش برای گزارش جدید content_owner_basic_a2 است. برخلاف نسخه قبلی گزارش، content_owner_basic_a1، نسخه جدید از سنجه‌های likes و dislikes پشتیبانی می‌کند.

    اگر ازقبل کاری برای ایجاد گزارش content_owner_basic_a1 دارید، همچنان باید کار جدیدی برای گزارش content_owner_basic_a2 ایجاد کنید. ‫YouTube به‌طور خودکار مالکان محتوا را به نسخه گزارش جدید منتقل نمی‌کند یا به‌طور خودکار کاری برای تولید نسخه گزارش جدید ایجاد نمی‌کند. در برخی پیاده‌سازی‌ها، ظاهر شدن یک کار جدید و غیرمنتظره می‌تواند تغییری مخرب باشد.

    هم‌زمان با انتشار گزارش جدید، گزارش content_owner_basic_a1 منسوخ شده است. اگر کاری برای آن گزارش دارید، نباید انتظار داشته باشید که YouTube پس‌از ۱۹ اوت ۲۰۱۶ گزارش‌های جدیدی برای آن کار تولید کند. گزارش‌های تولیدشده همچنان به‌مدت ۱۸۰ روز از زمان تولید دردسترس خواهند بود.

  • منابع reportType، job، و report همگی از ویژگی جدیدی پشتیبانی می‌کنند که مشخص می‌کند آیا منبع مرتبط نشان‌دهنده نوع گزارش منسوخ‌شده است یا نه:

    • ویژگی deprecateTime منبع reportType تاریخ و زمانی را که نوع گزارش منسوخ خواهد شد مشخص می‌کند. این ویژگی فقط برای گزارش‌هایی که به‌عنوان منسوخ‌شده اعلام شده‌اند مقدار دارد و این مقدار نشان‌دهنده تاریخی است که YouTube تولید گزارش‌های آن نوع را متوقف خواهد کرد.

      پس‌از اینکه نوع گزارش به‌عنوان منسوخ اعلام شد، YouTube گزارش‌های آن نوع را برای سه ماه دیگر تولید می‌کند. برای مثال، این به‌روزرسانی در ۱۹ مه ۲۰۱۶، منسوخ شدن گزارش content_owner_basic_a1 را اعلام می‌کند. بنابراین، deprecateTime برای آن نوع گزارش زمانی را در ۱۹ اوت ۲۰۱۶ مشخص می‌کند که پس‌از آن YouTube تولید گزارش‌های آن نوع را متوقف خواهد کرد.

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

    • ویژگی jobExpireTime منبع report تاریخ و زمان انقضای کاری را که با گزارش مرتبط است مشخص می‌کند. این ویژگی حاوی همان مقدار ویژگی expireTime در منبع job است، همان‌طور که در مورد قبلی در این فهرست شرح داده شده است.

  • اگر بخواهید برای گزارش منسوخ‌شده‌ای کار ایجاد کنید، روش jobs.create اکنون کد پاسخ‌های HTTP 400 (Bad Request) را برمی‌گرداند. علاوه‌براین، اسناد این روش اکنون چندین دلیل دیگر را که باعث ناموفق شدن درخواست میانای برنامه‌سازی کاربردی می‌شود فهرست می‌کند.

۱۲ آوریل ۲۰۱۶

این به‌روزرسانی شامل تغییرات زیر است که همگی فقط بر YouTube Reporting API تأثیر می‌گذارند:

  • اکنون YouTube داده‌های مربوط به دوره ۱۸۰ روزه قبل‌از اولین زمان‌بندی کار گزارش‌دهی را تولید می‌کند. قبلاً Reporting API هیچ داده قدیمی‌ای ارائه نمی‌کرد. این تغییر بر همه شغل‌ها، ازجمله شغل‌هایی که قبل‌از این اعلامیه ایجاد شده‌اند، تأثیر می‌گذارد.

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

    توجه داشته باشید که داده‌های قدیمی فقط از ۱ ژوئیه ۲۰۱۵ دردسترس است. درنتیجه، کارهایی که قبل‌از ۲۸ دسامبر ۲۰۱۵ ایجاد شده‌اند، کمتر از ۱۸۰ روز داده‌های قدیمی خواهند داشت.

    همه این تغییرات در بخش جدید داده‌های قدیمی در نمای کلی Reporting API توضیح داده شده است.

  • بخش ویژگی‌های گزارش در نمای کلی YouTube Reporting API با تغییرات زیر به‌روز شده است:

    • اکنون در اسناد ذکر شده است که گزارش‌ها برای مدت ۱۸۰ روز پس‌از تولید دردسترس هستند و بنابراین برای بارگیری توسط کارخواهان میانای برنامه‌سازی کاربردی دردسترس هستند. قبلاً در اسناد ذکر شده بود که گزارش‌ها برای دوره‌ای حداکثر تا شش ماه قبل‌از تاریخ ارسال درخواست API دردسترس هستند.

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

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

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

    • ویژگی جدید systemManaged منبع job نشان می‌دهد که آیا منبع شغلی را توصیف می‌کند که گزارش‌های مدیریت‌شده توسط سیستم را تولید می‌کند یا نه. YouTube به‌طور خودکار گزارش‌های مدیریت‌شده توسط سیستم را برای مالکان محتوای YouTube تولید می‌کند و مالکان محتوا نمی‌توانند کارهایی را که این گزارش‌ها را ��یجاد می‌کنند تغییر دهند یا حذف کنند.

    • پارامتر جدید includeSystemManaged در روش jobs.list نشان می‌دهد که آیا پاسخ میانای برنامه‌سازی کاربردی باید شامل کارهای مربوط به گزارش‌های مدیریت‌شده توسط سیستم باشد یا نه. مقدار پیش‌فرض پارامتر false است.

    • پارامتر جدید startTimeAtOrAfter در روش jobs.reports.list نشان می‌دهد که پاسخ میانای برنامه‌سازی کاربردی فقط باید حاوی گزارش‌هایی باشد که قدیمی‌ترین داده‌های آن‌ها در تاریخ مشخص‌شده یا پس‌از آن باشد. به‌طور مشابه، پارامتر startTimeBefore نشان می‌دهد که پاسخ میانای برنامه‌سازی کاربردی فقط باید حاوی گزارش‌هایی باشد که قدیمی‌ترین داده‌های موجود در گزارش قبل‌از تاریخ مشخص‌شده باشد.

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

    • ویژگی جدید systemManaged منبع reportType نشان می‌دهد که آیا منبع گزارش مدیریت‌شده توسط سیستم را توصیف می‌کند یا نه.

    • پارامتر جدید includeSystemManaged در روش reportTypes.list نشان می‌دهد که آیا پاسخ میانای برنامه‌سازی کاربردی باید شامل گزارش‌های مدیریت‌شده توسط سیستم باشد یا نه. مقدار پیش‌فرض پارامتر false است.

‫۲۸ مارس ۲۰۱۶

‫YouTube Reporting API و YouTube Analytics API اکنون آمار بازدید را برای چند سرویس هم‌رسانی دیگر برمی‌گردانند.

  • در YouTube Reporting API، بُعد sharing_service از این مقادیر جدید پشتیبانی می‌کند:
    • 82: کادر گفتگوی فعالیت سیستم iOS
    • 83: Google Inbox
    • ‫84: پیام‌رسان Android
  • در YouTube Analytics API، بُعد sharingService از این مقادیر جدید پشتیبانی می‌کند:
    • ‫ANDROID_MESSENGER: پیام‌رسان Android
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: کادر گفتگوی فعالیت سیستم iOS

‫۱۶ مارس ۲۰۱۶

این به‌روزرسانی شامل تغییرات زیر است که هم بر YouTube Reporting API و هم بر YouTube Analytics API تأثیر می‌گذارد:

YouTube Reporting API

  • بُعد playback_location_type از دو مقدار بُعد جدید پشتیبانی می‌کند:
    • 7: داده‌ها مربوط به بازدیدهایی است که در صفحه اصلی YouTube، در فید اشتراک کاربر، یا در یکی دیگر از ویژگی‌های مرور YouTube انجام شده است.
    • 8: داده‌ها مربوط به بازدیدهایی است که مستقیماً در صفحه نتایج جستجوی YouTube انجام شده است.
  • بُعد traffic_source_type اکنون از 18 به‌عنوان مقدار بُعد پشتیبانی می‌کند. این مقدار نشان می‌دهد که بازدیدهای ویدیو از صفحه‌ای منشأ گرفته‌اند که همه ویدیوهای یک فهرست پخش را فهرست می‌کند. این منبع با نوع منبع 14 متفاوت است که نشان می‌دهد بازدیدها زمانی رخ داده‌اند که ویدیو به‌عنوان بخشی از فهرست پخش درحال پخش بوده است.

YouTube Analytics API

  • بُعد insightPlaybackLocationType از دو مقدار بُعد جدید پشتیبانی می‌کند:
    • BROWSE: داده‌ها مربوط به بازدیدهایی است که در صفحه اصلی YouTube، در فید اشتراک کاربر، یا در یکی دیگر از ویژگی‌های مرور YouTube انجام شده است.
    • SEARCH: داده‌ها مربوط به بازدیدهایی است که مستقیماً در صفحه نتایج جستجوی YouTube انجام شده است.
  • بُعد insightTrafficSourceType اکنون از YT_PLAYLIST_PAGE به‌عنوان مقدار بُعد پشتیبانی می‌کند. این مقدار نشان می‌دهد که بازدیدهای ویدیو از صفحه‌ای منشأ گرفته‌اند که همه ویدیوهای یک فهرست پخش را فهرست می‌کند. این منبع با نوع منبع PLAYLIST متفاوت است که نشان می‌دهد بازدیدها زمانی رخ داده‌اند که ویدیو به‌عنوان بخشی از فهرست پخش درحال پخش بوده است.

۸ فوریه ۲۰۱۶

فهرست سنجه‌های پشتیبانی‌شده برای YouTube Analytics API به‌روزرسانی شده است تا سنجه‌های کارت دیگر به‌عنوان سنجه‌های پشتیبانی‌شده برای آن API فهرست نشوند. (هیچ‌کدام از گزارش‌های آن API به‌عنوان پشتیبانی از هیچ‌یک از سنجه‌های کار�� مستند نشده بود.)

توجه داشته باشید که همچنان می‌توانید سنجه‌های کارت را بااستفاده از YouTube Reporting API بازیابی کنید که از این سنجه‌ها برای گزارش‌های متعدد کانال و مالک محتوا پشتیبانی می‌کند.

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

‫YouTube Reporting API و YouTube Analytics API اکنون به‌طور خاص بازدیدهایی را که ازطریق دستگاه Chromecast انجام می‌شوند شناسایی می‌کنند.

  • در YouTube Reporting API، بُعد operating_system از مقدار 21 برای شناسایی بازدیدهایی که ازطریق Chromecast انجام می‌شوند استفاده می‌کند.
  • در YouTube Analytics API، بُعد operatingSystem از مقدار CHROMECAST برای شناسایی بازدیدهایی که ازطریق Chromecast انجام می‌شوند استفاده می‌کند.

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

در اسناد، نام‌های سنجه‌های annotation_clickable_impressions و annotation_closable_impressions به‌روز شده‌اند تا با نام‌هایی که در گزارش‌ها برگردانده می‌شوند مطابقت داشته باشند. قبلاً، نام‌ها به‌صورت clickable_annotation_impressions و closable_annotation_impressions ثبت شده بود.

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

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

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

این به‌روزرسانی شامل تغییرات زیر است که همگی بر YouTube Analytics API تأثیر می‌گذارند:

  • ‫YouTube Analytics API اکنون از سه ب��عد ج����ی��ت بازپخش جدید پشتیبانی می‌کند که می‌توان از آن‌ها در انواع گزارش‌های مالک محتوا و کانال استفاده کرد:

    • liveOrOnDemand: این بُعد نشان می‌دهد که آیا داده‌های موجود در گزارش، فعالیت کاربر را که درطول پخش زنده رخ داده است توصیف می‌کند یا نه.
    • subscribedStatus: این بُعد نشان می‌دهد که آیا سنجه‌های فعالیت کاربر در داده‌ها با بینندگانی که مشترک کانال ویدیو یا فهرست پخش بوده‌اند مرتبط است یا خیر.
    • youtubeProduct: این بُعد دارایی YouTube را که فعالیت کاربر در آن رخ داده است شناسایی می‌کند. مقادیر احتمالی شامل وب‌سایت اصلی YouTube (یا برنامه YouTube)،‏ YouTube Gaming، و YouTube Kids است.

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

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

    دارایی مقدار
    ابعاد:
    الزامی deviceType
    استفاده از ۰ یا بیشتر day، liveOrOnDemand، subscribedStatus، youtubeProduct
    سنجه‌ها:
    استفاده از ۱ یا بیشتر بازدیدها، estimatedMinutesWatched
    فیلترها:
    از ۰ یا ۱ استفاده کنید country، province، continent، subContinent
    از ۰ یا ۱ استفاده کنید ویدیو، گروه
    استفاده از ۰ یا بیشتر operatingSystem، liveOrOnDemand، subscribedStatus، youtubeProduct

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

  • YouTube Analytics API اکنون به‌طور خودکار نهادهایی را که کاربر API نمی‌تواند داده‌های آن‌ها را از فیلترهای پشتیبانی‌کننده از چند مقدار (video، playlist، و channel) بازیابی کند حذف می‌کند. قبلاً اگر کاربر API نمی‌توانست به داده‌های حداقل یکی از موارد مشخص‌شده دسترسی پیدا کند، سرور API فقط یک خطا برمی‌گرداند.

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

  • اگر داده‌های مربوط به YouTube Analytics group خالی را درخواست کنید، اکنون API به‌جای خطا، مجموعه داده‌های خالی را برمی‌گرداند.

  • اکنون اگر بخواهید موجودیتی را به گروهی اضافه کنید اما به آن موجودیت دسترسی نداشته باشید، روش groupItems.insert در YouTube Analytics API خطای غیرمجاز (کد پاسخ HTTP‏ 403) را برمی‌گرداند. قبلاً، API به شما اجازه می‌داد نهاد را به گروه اضافه کنید، اما بعداً وقتی می‌خواستید داده‌های گزارش را برای آن گروه بازیابی کنید، خطای غیرمجاز برمی‌گرداند.

  • روش groups.list در YouTube Analytics API اکنون از صفحه‌بندی پشتیبانی می‌کند. اگر پاسخ میانای برنامه‌سازی کاربردی حاوی همه گروه‌های دردسترس نباشد، پارامتر nextPageToken پاسخ، یک توکن را مشخص می‌کند که می‌تواند برای بازیابی صفحه بعدی نتایج استفاده شود. پارامتر pageToken روش را روی آن مقدار تنظیم کنید تا نتایج بیشتری بازیابی شود.

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

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

  • ‫YouTube Analytics API اکنون از سنجه redPartnerRevenue پشتیبانی می‌کند که مجموع درآمد تخمینی کسب‌شده از اشتراک‌های YouTube Red را برای ابعاد گزارش انتخاب‌شده گزارش می‌کند. مقدار این سنجه نشان‌دهنده درآمد حاصل ا�� محتوای موسیقی و غیرموسیقی است و در پایان ماه اصلاح می‌شود.

    فهرست گزارش‌های مالک محتوا در YouTube Analytics API به‌روزرسانی شده است تا گزارش‌های ویدیویی را که از سنجه redPartnerRevenue پشتیبانی می‌کنند شناسایی کند:

  • تعریف گزارش ویدیوهای برتر برای YouTube Analytics API اکنون نشان می‌دهد که این گزارش از سنجه‌های درآمد زیر نیز پشتیبانی می‌کند: earnings، adEarnings، grossRevenue، monetizedPlaybacks، playbackBasedCpm، impressions، و impressionBasedCpm.

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

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

  • اسناد مربوط به بُعد date در YouTube Reporting API اصلاح شده است تا نشان دهد که تاریخ‌ها به دوره ۲۴ ساعته‌ای اشاره دارند که از ساعت ۱۲:۰۰ بامداد به وقت اقیانوس آرام (UTC-8) شروع می‌شود. قبلاً در اسناد ذکر شده بود که تاریخ از ساعت ۱۲:۰۰ بامداد (به‌وقت گرینویچ) شروع می‌شود.

    علاوه‌براین، اسناد YouTube Analytics API به‌روزرسانی شده است تا مشخص شود که همه ابعاد مربوط به تاریخ (day، 7DayTotals، 30DayTotals، و month) به تاریخ‌هایی اشاره دارند که از ساعت ۱۲:۰۰ بامداد به‌وقت اقیانوس آرام (UTC-8) شروع می‌شوند.

  • روش jobs.reports.list() در YouTube Reporting API اکنون از پارامتر پُرسمان createdAfter پشتیبانی می‌کند. اگر مشخص شود، این پارامتر نشان می‌دهد که پاسخ میانای برنامه‌سازی کاربردی باید فقط گزارش‌های ایجادشده پس‌از تاریخ و زمان مشخص‌شده را فهرست کند، ازجمله گزارش‌های جدید با داده‌های پرشده از گذشته. توجه داشته باشید که مقدار پارامتر مربوط به زمانی است که گزارش ایجاد شده است و نه تاریخ‌های مرتبط با داده‌های برگردانده‌شده.

    مقدار پارامتر مُهر زمان در قالب RFC3339 UTC «Zulu» است که تا میکروثانیه دقیق است. مثال: "2015-10-02T15:01:23.045678Z".

    روال‌های مطلوب YouTube Reporting API نیز به‌روزرسانی شده‌اند تا توضیح دهند که چگونه می‌��وانید از پارامتر createdAfter برای جلوگیری از پردازش مکرر یک گزارش استفاده کنید.

  • تعاریف ویژگی createTime منبع job و ویژگی‌های startTime، endTime، و createTime منبع report همگی اصلاح شده‌اند تا مشخص شود که مقادیر ویژگی‌ها تا حد میکروثانیه دقیق هستند، نه نانوثانیه. علاوه‌براین، اکنون همه تعاریف به‌درستی نشان می‌دهند که مقدار ویژگی یک مُهر زمان است.

‫۸ اکتبر ۲۰۱۵

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

  • اسناد مربوط به بُعد sharingService در YouTube Analytics API به‌روز شده است تا شامل فهرستی از مقادیر ممکن برای بُعد باشد. این فهرست شامل تعدادی از سرویس‌هایی است که به‌تازگی پشتیبانی می‌شوند.

    تعریف بُعد sharing_service در YouTube Reporting API نیز به‌روز شده است تا مقادیر جدید پشتیبانی‌شده را فهرست کند. مقادیر enum که بزرگ‌تر از 59 هستند، مقادیر جدید در فهرست هستند.

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

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

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

    هر گزارش YouTube Reporting API شامل مجموعه‌ای ازپیش‌تعریف‌شده از ابعاد و سنجه‌ها است. (گزارش‌های YouTube Analytics API نیز از سنجه‌ها و ابعاد استفاده می‌کنند.) در گزارش، هر ردیف داده ترکیب منحصربه‌فردی از مقادیر بُعد دارد. می‌توانید داده‌ها را در ردیف‌ها براساس مقادیر بُعد تجمیع کنید تا سنجه‌ها را برای ویدیوهای تکی، کشورها، ویدیوهای زنده، کاربران مشترک، و غیره محاسبه کنید.

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

  • اگرچه این دو API متفاوت هستند، اما YouTube Analytics API و YouTube Reporting API هر دو به توسعه‌دهندگان امکان می‌دهند داده‌های YouTube Analytics را بازیابی کنند. ازآنجاکه هر دو میانای برنامه‌سازی کاربردی دسترسی به مجموعه‌های داده مشابهی را فراهم می‌کنند، اسناد این دو میانای برنامه‌سازی کاربردی به‌عنوان یک مجموعه واحد از اسناد منتشر می‌شود.

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

‫۲۰ اوت ۲۰۱۵

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

  • مستندات میانای برنامه‌سازی کاربردی بازسازی شده است تا درک میانای برنامه‌سازی کاربردی آسان‌تر شود. بنابراین، این تغییرات ویژگی‌های جدید را ��و��یف نمی‌کنند:

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

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

    • روش reports.query میانای برنامه‌سازی کاربردی که برای بازیابی گزارش‌ها استفاده می‌کنید اکنون به‌طور جداگانه مستند شده است. اطلاعات موجود در آن صفحه قبلاً در برخی صفحه‌های دیگر وجود داشته است. صفحه جدید به‌گونه‌ای طراحی شده است که به شما کمک کند اطلاعاتی را که باید برای بازیابی گزارش ارسال کنید راحت‌تر شناسایی کنید.

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

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

  • سنجه جدید adEarnings شامل مجموع تخمینی درآمدها (درآمد خالص) از همه منابع تبلیغاتی فروخته‌شده توسط Google است. این سنجه اصلی نیست. این میانای برنامه‌سازی کاربردی از سنجه adEarnings برای هر گزارشی که ازقبل از سنجه earnings پشتیبانی می‌کرده است پشتیبانی می‌کند.

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

  • سنجه primaryAdGrossRevenue منسوخ شده است. به‌جای آن، از سنجه grossRevenue برای بازیابی داده‌های درآمد استفاده کنید.

  • علاوه‌بر سنجه منسوخ‌شده primaryAdGrossRevenue، گزارش‌های عملکرد آگهی دیگر از سنجه‌های monetizedPlaybacks و playbackBasedCpm پشتیبانی نمی‌کنند. بااین‌حال، چندین گزارش ویدیو هنوز از این سنجه‌ها پشتیبانی می‌کنند.

۱ ژوئن ۲۰۱۵

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

  • اکنون API از دو سنجه جدید برای گزارش‌های ویدیو، videosAddedToPlaylists و videosRemovedFromPlaylists، پشتیبانی می‌کند. فهرست‌های گزارش‌های ویدیویی برای کانال‌ها و مالکان محتوا هر دو به‌روزرسانی شده‌اند تا گزارش‌هایی را که از سنجه‌های جدید پشتیبانی می‌کنند شناسایی کنند.

    • videosAddedToPlaylists – تعداد دفعاتی که ویدیوهای موجود در محدوده پُرسمان به هر فهرست پخش YouTube اضافه شده‌اند. ویدیوها ممکن است به فهرست پخش مالک ویدیو یا به فهرست‌های پخش کانال‌های دیگر اضافه شده باشند.
    • videosRemovedFromPlaylists – تعداد دفعاتی که ویدیوهای موجود در محدوده پُرسمان از هر فهرست پخش YouTube برداشته شده‌اند. ویدیوها ممکن است از فهرست پخش مالک ویدیو یا از فهرست‌های پخش کانال‌های دیگر حذف شده باشند.

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

    داده‌های این سنجه‌ها از ۱ اکتبر ۲۰۱۴ دردسترس است.

۳۱ مارس ۲۰۱۵

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

  • سنجه‌های favoritesAdded و favoritesRemoved هر دو از تاریخ این اعلامیه منسوخ شده‌اند. هر دو این‌ها سنجه‌های اصلی هستند و تابع «خط‌مشی منسوخ کردن» هستند که در شرایط خدمات ذکر شده است.

‫۱۶ مارس ۲۰۱۵

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

  • پارامتر جدید currency به شما امکان می‌دهد سنجه‌های درآمد را به ارزی غیراز دلار امریکا (USD) بازیابی کنید. اگر پارامتر تنظیم شده باشد، API مقادیر سنجه‌های earnings، grossRevenue، playbackBasedCpm، و impressionBasedCpm را به ارز مشخص‌شده تبدیل می‌کند. مقادیر برگشتی تخمین‌هایی هستند که بااستفاده از نرخ‌های تبدیل ارز محاسبه می‌شوند که به‌صورت روزانه تغییر می‌کنند.

    مقدار پارامتر یک کد ارز ISO 4217 سه‌حرفی است. مقدار پیش‌فرض USD است. تعریف پارامتر حاوی فهرستی از کدهای ارز پشتیبانی‌شده است.

‫۲۵ فوریه ۲۰۱۵ (۶ اسفند ۱۳۹۳)

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

  • اکنون API از توانایی ایجاد و مدیریت گروه‌های YouTube Analytics و همچنین توانایی بازیابی داده‌های گزارش برای آن گروه‌ها پشتیبانی می‌کند.

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

      این به‌روزرسانی منابع group و groupItem را برای ایجاد و مدیریت گروه‌ها معرفی می‌کند.

      • منبع group نشان‌دهنده یک گروه Analytics است، مجموعه‌ای سفارشی از حداکثر ۲۰۰ کانال، ویدیو، فهرست پخش، یا دارایی. این میانای برنامه‌سازی کاربردی از روش‌های list، insert، update، و delete برای این منبع پشتیبانی می‌کند.
      • منبع groupItem نشان‌دهنده موردی در گروه Analytics است. میانای برنامه‌سازی کاربردی از روش‌های list، insert، و delete برای این منبع پشتیبانی می‌کند.

      بنابراین، برای مثال، می‌توانید بااستفاده از روش groups.insert گروهی ایجاد کنید و سپس بااستفاده از روش groupItems.insert مواردی را به آن گروه اضافه کنید.

    • بازیابی داده‌های گزارش برای گروه

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

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

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

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

  • میانای برنامه‌سازی کاربردی دیگر از بُعد show پشتیبانی نمی‌کند.

‫۲۸ اوت ۲۰۱۴

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

  • اکنون API از توانایی تعیین چندین مقدار برای ابعاد video، playlist، channel، و show در زمانی که این ابعاد به‌عنوان فیلتر استفاده می‌شوند پشتیبانی می‌کند. برای مشخص کردن چند مقدار، مقدار پارامتر filters را روی فهرستی از شناسه‌های ویدیو، فهرست پخش، کانال، یا نمایش تنظیم کنید که با کاما از هم جدا شده‌اند و پاسخ میانای برنامه‌سازی کاربردی باید براساس آن‌ها فیلتر شود. مقدار پارامتر می‌تواند تا ۲۰۰ شناسه را مشخص کند.

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

    برای جزئیات کامل درباره این عملکرد، تعریف پارامتر filters را ببینید.

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

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

  • هنگام بازیابی گزارش کانال، اکنون می‌توانید با تنظیم مقدار پارامتر ids روی channel==MINE، داده‌های کانال کاربر اصالت‌سنجی‌شده را بازیابی کنید. (همچنین می‌توانید پارامتر ids را روی channel==CHANNEL_ID تنظیم کنید تا داده‌های کانال مشخص‌شده را بازیابی کنید.)

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

    همه گزارش‌های فهرست پخش از سنجه‌های views و estimatedMinutesWatched پشتیبانی می‌کنند و برخی نیز از سنجه averageViewDuration پشتیبانی می‌کنند.

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

    • playlistStarts: تعداد دفعاتی که بینندگان بازپخش یک فهرست پخش را آغاز کرده‌اند.
    • viewsPerPlaylistStart: میانگین تعداد بازدیدهای ویدیو که هر بار که یک فهرست پخش شروع می‌شود، رخ می‌دهد.
    • averageTimeInPlaylist: میانگین تخمینی مدت زمانی (به دقیقه) که بیننده ویدیوهای موجود در فهرست پخش را پس‌از شروع فهرست پخش تماشا کرده است.

    هر درخواستی برای بازیابی گزارش فهرست پخش باید از فیلتر isCurated استفاده کند که باید روی 1 (isCurated==1) تنظیم شده باشد.

  • اکنون API از گزارش حفظ مخاطب پشتیبانی می‌کند. این گزارش توانایی ویدیو در حفظ مخاطبانش را می‌سنجد. بُعد جدید elapsedVideoTimeRatio گزارش، مقدار ویدیویی را که برای مقادیر سنجه مربوطه سپری شده است اندازه‌گیری می‌کند:

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

      توجه داشته باشید که ممکن است بخشی از ویدیو بیش‌از یک بار (یا اصلاً) در یک بازدید ویدیو تماشا شود. برای مثال، اگر کاربران همان بخش از ویدیو را چندین بار به عقب برگردانند و تماشا کنند، نسبت مطلق برای آن بخش از ویدیو می‌تواند بیشتر از 1 باشد.

    • سنجه relativeRetentionPerformance نشان می‌دهد که یک ویدیو در مقایسه با همه ویدیوهای YouTube با طول مشابه، چقدر خوب بینندگان را درطول بازپخش حفظ می‌کند. مقدار ۰ نشان می‌دهد که ویدیو نسبت‌به هر ویدیو دیگری با طول مشابه، بینندگان را کمتر حفظ می‌کند، درحالی‌که مقدار ۱ نشان می‌دهد که ویدیو نسبت‌به هر ویدیو دیگری با طول مشابه، بینندگان را بهتر حفظ می‌کند. مقدار میانه ۰٫۵ نشان می‌دهد که نیمی از ویدیوهای با طول مشابه، بینندگان را بهتر حفظ می‌کنند درحالی‌که نیمی دیگر بینندگان را بدتر حفظ می‌کنند.

    همچنین می‌توانید از فیلتر audienceType استفاده کنید تا گزارش فقط داده‌های مربوط به بازدیدهای طبیعی، بازدیدهای ناشی از آگهی‌های حین جاری‌سازی TrueView، یا بازدیدهای ناشی از آگهی‌های TrueView در نمایش را برگرداند. (بازدیدهای عادی نتیجه مستقیم کنش کاربر است، مثل جستجوی ویدیو یا کلیک روی ویدیو پیشنهادی.)

  • این API از چندین سنجه جدید مربوط به حاشیه‌نویسی‌ها پشتیبانی می‌کند. سنجه‌های فهرست‌شده در زیر را می‌توان با هر گزارشی که قبلاً از سنجه‌های annotationClickThroughRate و annotationCloseRate پشتیبانی می‌کرد بازیابی کرد.

    همه سنجه‌های جدید سنجه‌های اصلی هستند و مشمول خط‌مشی منسوخ کردن می‌شوند. اما توجه داشته باشید که داده‌ها برای سنجه‌های جدید از ۱۶ ژوئیه ۲۰۱۳ دردسترس است. (داده‌های مربوط به سنجه‌های annotationClickThroughRate و annotationCloseRate از ۱۰ ژوئن ۲۰۱۲ دردسترس است.)

  • GOOGLE_SEARCH دیگر به‌عنوان مقدار جداگانه‌ای برای بُعد insightTrafficSourceType گزارش نمی‌شود. درعوض، ارجاع‌ها از نتایج جستجوی Google اکنون به نوع منبع ترافیک EXT_URL نسبت داده می‌شوند. درنتیجه، ��یگر ��مکان بازیابی ��زارش insightTrafficSourceDetail که فیلتر insightTrafficSourceType را روی GOOGLE_SEARCH تنظیم می‌کند وجود ندارد.

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

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

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

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

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

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

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

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

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

  • تعریف بُعد province به‌روزرسانی شده است تا مشخص شود که وقتی province در مقدار پارامتر dimensions گنجانده شده است، درخواست باید با گنجاندن country==US در مقدار پارامتر filters، داده‌ها را به ایالات متحده محدود کند.

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

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

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

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

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

  • اکنون API از سه بعد جغرافیایی جدید پشتیبانی می‌کند: province، continent، و subContinent.

    • بُعد province به شما امکان می‌دهد آمار ایالت‌های ایالات متحده و منطقه کلمبیا را بازیابی کنید. این API از دو کاربرد برای این بُعد پشتیبانی می‌کند:

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

        • گزارش آمار اصلی چندین آمار را ارائه می‌دهد، ازجمله تعداد بازدیدها و دقایق تماشای تخمینی.
        • گزارش زمان‌محور همان آمار را ارائه می‌دهد، اما داده‌ها را به‌صورت روزانه، ۷ روزه، ۳۰ روزه، یا ماهانه تجمیع می‌کند.

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

    • بعد continent کد منطقه آماری سازمان ملل (UN) را مشخص می‌کند که یک قاره را شناسایی می‌کند. این بُعد فقط می‌تواند به‌عنوان فیلتر استفاده شود.

    • بُعد subContinent کد منطقه آماری سازمان ملل (UN) را مشخص می‌کند که زیرمنطقه یک قاره را شناسایی می‌کند. این بُعد را فقط می‌توان به‌عنوان فیلتر استفاده کرد.

      ازآنجایی‌که هر زیرمنطقه فقط با یک قاره مرتبط است، نیازی نیست که هنگام استفاده از فیلتر subContinent از فیلتر continent نیز استفاده کنید. (درواقع، اگر درخواستی از هر دو بُعد استفاده کند، API خطا برمی‌گرداند.)

  • اسناد اصلاح شده است تا بُعد insightTrafficSourceDetail مقدار insightTrafficSourceType PROMOTED را به‌عنوان مقدار فیلتر معتبر دربر نگیرد.

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

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

  • ‫YouTube Analytics API اکنون مشمول «خط‌مشی منسوخ کردن» شرح‌داده‌شده در شرایط خدمات است. بااین‌حال، ابعاد غیرهسته‌ای و سنجه‌های غیرهسته‌ای میانای برنامه‌سازی کاربردی مشمول «خط‌مشی منسوخ کردن» نیستند. صفحه‌های ابعاد و سنجه‌ها به‌روزرسانی شده‌اند تا ابعاد اصلی و سنجه‌های اصلی را فهرست کنند. علاوه‌براین، تعاریف موجود در آن صفحه‌ها به‌روز شده‌اند تا ابعاد و سنجه‌های اصلی را به‌طور صریح شناسایی کنند.

  • اکنون میانای برنامه‌سازی کاربردی از EXTERNAL_APP به‌عنوان مقداری برای بُعد insightPlaybackLocationType پشتیبانی می‌کند. در ارتباط با این به‌روزرسانی، از ۱۰ سپتامبر ۲۰۱۳، بازپخش‌ها دیگر به‌عنوان بازپخش‌های MOBILE دسته‌بندی نمی‌شوند، اگرچه بازپخش‌های تلفن همراه که قبل از آن تاریخ رخ داده‌اند همچنان با آن مقدار دسته‌بندی می‌شوند.

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

  • اکنون API از PLAYLIST به‌عنوان مقداری برای بُعد insightTrafficSourceType پشتیبانی می‌کند. این مقدار نشان می‌دهد که بازدیدهای ویدیو از یک فهرست پخش ارجاع داده شده‌اند. قبلاً، این بازدیدها بااستفاده از دسته YT_OTHER_PAGE بُعد طبقه‌بندی می‌شدند.

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

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

  • اکنون میانای برنامه‌سازی کاربردی از قابلیت مرتب‌سازی گزارش‌ها براساس چند بُعد و سنجه پشتیبانی می‌کند. سند درخواست‌های نمونه حاوی مثال جدیدی است، مرتب‌سازی درخواست‌ها براساس چند بُعد/ سنجه، که این عملکرد را نشان می‌دهد. درخواست داده‌های منبع ترافیک را بازیابی می‌کند و مقدار پارامتر sort آن day,-views است. نتایج به‌ترتیب زمانی مرتب می‌شوند، اما در مجموعه نتایج هر روز، ردیف اول حاوی داده‌های منبع ترافیکی است که بیشترین بازدید را ایجاد کرده است، ردیف دوم حاوی داده‌های منبعی است که بیشترین بازدید بعدی را ایجاد کرده است، و به همین ترتیب.

  • اکنون API از دو بُعد جدید deviceType و operatingSystem پشتیبانی می‌کند که می‌توان از آن‌ها برای بازیابی داده‌های مربوط به دستگاه‌هایی که بینندگان ویدیوهای شما را ��ر آن‌ها تماشا می‌کنند استفاده کرد. این API از گزارش‌هایی که از یک یا هر دو بُعد استفاده می‌کنند پشتیبانی می‌کند.

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

    • گزارش operatingSystem به شما امکان می‌دهد تعداد بازدیدها و زمان تماشای تخمینی را برای سیستم‌عامل‌های مختلف مانند Android،‏ iOS،‏ Linux و غیره بازیابی کنید. همچنین می‌توانید از فیلتر deviceType استفاده کنید تا گزارش سیستم‌عامل را محدود کنید تا فقط آمار نوع خاصی از دستگاه، مانند دستگاه‌های همراه یا رایانه‌های لوحی را دربرگیرد.

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

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

  • بُعد insightPlaybackLocationType ممکن است مقدار YT_OTHER را برگرداند که بازدیدهایی را شناسایی می‌کند که بااستفاده از یکی از مقادیر دیگر بُعد طبقه‌بندی نشده‌اند.

۲۳ مه ۲۰۱۳

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

‫۱۰ مه ۲۰۱۳

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

‫۶ مه ۲۰۱۳

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

  • اکنون API از قابلیت بازیابی سنجه‌های زمان تماشا – estimatedMinutesWatched، averageViewDuration، و averageViewPercentage – در کنار سایر سنجه‌ها، ازجمله سنجه‌های بازدید، سنجه‌های تعامل، سنجه‌های درآمد، و سنجه‌های عملکرد آگهی پشتیبانی می‌کند.

    فهرست‌های گزارش‌های کانال و گزارش‌های مالک محتوا دردسترس برای انعکاس این تغییر به‌روز شده‌اند. (اکنون فهرست‌ها کوتاه‌تر شده‌اند زیرا سنجه‌های زمان تماشا را می‌توان به‌عنوان بخشی از دیگر گزارش‌های فهرست‌شده بازیابی کرد.)

    سند نمونه درخواست‌های API نیز به‌روز شده است.

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

    • اکنون از فیلتر اختیاری country پشتیبانی می‌کنند.

    • مالکان محتوا اکنون می‌توانند این گزارش‌ها را بااستفاده از هریک از ترکیب‌های جدید filter زیر بازیابی کنند. توجه داشته باشید که همه این ترکیب‌ها از فیلتر اختیاری country نیز پشتیبانی می‌کنند.

      • جزئیات مکان بازپخش

        • channel,insightPlaybackLocationType==EMBEDDED
        • show,insightPlaybackLocationType==EMBEDDED
        • claimedStatus,insightPlaybackLocationType==EMBEDDED
        • uploaderType,insightPlaybackLocationType==EMBEDDED
        • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

      • جزئیات منبع ترافیک

        • channel,insightTrafficSourceType
        • show,insightTrafficSourceType
        • claimedStatus,insightTrafficSourceType
        • uploaderType,insightTrafficSourceType
        • uploaderType,claimedStatus,insightTrafficSourceType

۳ مه ۲۰۱۳

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

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

  • بُعد insightTrafficSourceType اکنون از SUBSCRIBER به‌عنوان مقدار معتبر پشتیبانی می‌کند. این مقدار بازدیدهای ویدیویی را شناسایی می‌کند که از فیدهای صفحه اصلی YouTube یا از ویژگی‌های اشتراک YouTube ارجاع داده شده‌اند. اگر براساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail فید صفحه اصلی یا صفحه دیگری را که بازدیدها از آن ارجاع داده شده‌اند مشخص می‌کند.

‫۲۸ مارس ۲۰۱۳

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

  • اکنون API از دو سنجه جدید annotationClickThroughRate و annotationCloseRate پشتیبانی می‌کند که مربوط به تعاملات بیننده با حاشیه‌نویسی‌هایی است که درطول ویدیوهای شما نمایش داده می‌شود. فهرست‌های گزارش‌های کانال و گزارش‌های مالک محتوا هر دو به‌روزرسانی شده‌اند تا گزارش‌هایی را که از سنجه‌های جدید پشتیبانی می‌کنند شناسایی کنند.

    • annotationClickThroughRate – نسبت حاشیه‌نویسی‌هایی که بینندگان روی آن‌ها کلیک کرده‌اند به تعداد کل دفعات نمایش حاشیه‌نویسی‌های قابل کلیک.
    • annotationCloseRate – نسبت حاشیه‌نویسی‌هایی که بینندگان بسته‌اند به تعداد کل ظهورهای حاشیه‌نویسی.

۲۱ مارس ۲۰۱۳

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

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

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

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

      • earnings – مجموع تخمینی درآمدها از همه منابع تبلیغاتی فروخته‌شده توسط Google.
      • grossRevenue – درآمد ناخالص تخمینی از شرکای Google یا DoubleClick.
      • primaryAdGrossRevenue – درآمد ناخالص تخمینی، جمع‌بندی‌شده و طبقه‌بندی‌شده تحت نوع آگهی اصلی برای بازپخش‌های ویدیویی که گزارش پوشش می‌دهد، از Google یا شرکای DoubleClick.
      • monetizedPlaybacks – تعداد بازپخش‌هایی که حداقل یک ظهور آگهی را نشان داده‌اند.
      • playbackBasedCpm – درآمد ناخالص تخمینی به‌ازای هر هزار بازپخش.
      • impressions – تعداد ظهورهای آگهی تأییدشده ارائه‌شده.
      • impressionBasedCpm – درآمد ناخالص تخمینی به‌ازای هر هزار ظهور آگهی.

      توجه: برای جزئیات کامل، تعاریف سنجه را ببینید.

    • هر درخواستی که سنجه‌های عملکرد آگهی یا درآمد خالص را بازیابی می‌کند باید یک توکن مجوز ارسال کند که بااستفاده از دامنه جدید https://www.googleapis.com/auth/yt-analytics-monetary.readonly دسترسی اعطا می‌کند.

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

‫۴ فوریه ۲۰۱۳

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

  • راهنمای مرجع میانای برنامه‌سازی کاربردی اکنون دارای بخش نمونه‌ها است که شامل نمونه کدهایی است که نحوه فراخوانی میانای برنامه‌سازی کاربردی را بااستفاده از کتابخانه‌های کارخواه Java،‏ JavaScript،‏ Python، و Ruby نشان می‌دهد. نمونه کد جاوا اسکریپت همان نمونه‌ای است که به‌طور مفصل در اسناد نمونه برنامه مورد بحث قرار گرفته است.

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

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

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

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

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

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

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

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

    • گزارش‌های زمان تماشا مقدار زمانی را که بینندگان صرف تماشای محتوای شما کرده‌اند ارائه می‌دهد. گزارش‌ها می‌توانند داده‌ها را برای یک بازه زمانی خاص (روز، ه��ت روز گذشته، ۳۰ روز گذشته، و غیره) یا کشور تجمیع کنند. اگر گزارشی داده‌ها را براساس روز یا کشور تجمیع کند، می‌تواند میانگین مدت هر بازدید ویدیو و همچنین میانگین درصد هر ویدیویی را که کاربران تماشا کرده‌اند مشخص کند.

‫۲ اکتبر ۲۰۱۲

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

  • YouTube Analytics API اکنون برای همه توسعه‌دهندگان دردسترس است. می‌توانید میانای برنامه‌سازی کاربردی را برای پروژه‌تان، بدون نیاز به درخواست دسترسی، از پانل سرویس‌ها در APIs console فعال کنید.

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

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

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

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

  • بخش ابعاد زمانی به‌روزرسانی شده است تا توضیح دهد که این ابعاد نشان می‌دهند که گزارش Analytics باید داده‌ها را براساس یک دوره زمانی تجمیع کند. این میانای برنامه‌سازی کاربردی اکنون از ابعاد زمانی اضافی زیر پشتیبانی می‌کند:

    • 7DayTotals – داده‌های گزارش انبوهش خواهد شد تا هر ردیف حاوی داده‌های یک دوره هفت‌روزه باشد.
    • 30DayTotals – داده‌های گزارش انبوهش خواهد شد تا هر ردیف حاوی داده‌های یک دوره ۳۰ روزه باشد.
    • month – داده‌های گزارش براساس ماه تقویمی جمع‌آوری خواهد شد.

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

  • بخش ابعاد نهاد گزارش‌دهنده به‌روزرسانی شده است تا اشاره کند که درخواست‌های API برای بازیابی گزارش‌های مالک محتوا باید داده‌ها را بااستفاده از یکی از این ابعاد (video، channel، یا show) یا ترکیبی پشتیبانی‌شده از ابعاد claimedStatus و uploaderType فیلتر کنند.

  • اکنون API از دو گزینه مرتب‌سازی جدید برای گزارش‌های ویدیوهای برتر پشتیبانی می‌کند. این گزارش‌ها که به‌صورت گزارش‌های کانال یا گزارش‌های مالک محتوا دردسترس هستند، حاوی سنجه‌هایی (بازدیدها، نظرات، پسندیدن‌ها، و غیره) براساس هر کشور هستند و این سنجه‌ها را براساس ویدیو تفکیک می‌کنند. اکنون می‌توانید این گزارش‌ها را براساس تعداد کاربرانی که از صفحه تماشای ویدیو در کانال مشترک شده‌اند یا اشتراکشان را لغو کرده‌اند مرتب کنید.

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