نمونه درخواست های API

این صفحه نمونه درخواست های YouTube Analytics API را نشان می دهد. هر مثال به طور خلاصه گزارش بازیابی شده را توصیف می کند و سپس dimensions ، metrics ، filters و مقادیر پارامتر sort مربوطه را نشان می دهد. ( گزارش‌های کانال و اسناد گزارش مالک محتوا گزارش‌هایی را که API پشتیبانی می‌کند مشخص می‌کند.)

هر نمونه به Google APIs Explorer پیوند داده شده و با مقادیر نشان داده شده پر می شود. نمونه ها همچنین از تاریخ های شروع و پایان پیش فرض ( YYYY-MM-DD ) 2023-09-01 و 2024-03-31 استفاده می کنند.

پس از پیوند دادن به APIs Explorer، همچنان باید کانال یا مالک محتوایی را که گزارش‌ها را برای آن بازیابی می‌کنید، مشخص کنید. APIs Explorer مقدار پارامتر ids را با channel==MINE یا contentOwner==CONTENT_OWNER_ID پر می کند، بسته به درخواستی که روی آن کلیک کرده اید. برای گزارش های کانال، می توانید MINE به شناسه کانال کاربر تأیید شده تغییر دهید. برای گزارش‌های مالک محتوا، باید شناسه مالک محتوای خود را جایگزین CONTENT_OWNER_ID کنید.

همچنین باید به عنوان مالک کانال یا محتوای مشخص شده احراز هویت شوید تا APIs Explorer بتواند درخواست‌های API شما را با استفاده از OAuth 2.0 تأیید کند.

1. مرتب سازی درخواست ها بر اساس ابعاد/متریک های متعدد
2. گزارش کانال
3. گزارش صاحب محتوا

مرتب سازی درخواست ها بر اساس ابعاد/متریک های متعدد

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

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

گزارش کانال

آمار اولیه

گزارش های تصویری

تعداد کل بازدیدها، زمان تخمینی تماشا و موارد دیگر برای یک کانال

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

تعداد بازدیدهای خاص کشور (و بیشتر) برای یک کانال

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

10 مورد برتر – پربیننده ترین ویدیوهای یک کانال

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

توجه: این گزارش از شما می‌خواهد که مقداری برای پارامتر درخواست sort مشخص کنید و پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

10 برتر – نرخ کلیک حاشیه نویسی برای ویدیوهای کانال که بیشترین بازدید را داشته است

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

توجه: این گزارش از شما می‌خواهد که مقداری برای پارامتر درخواست sort مشخص کنید و پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

گزارش لیست پخش

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

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

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

آمار برای یک لیست پخش خاص

این درخواست کل شروع‌های فهرست پخش، دقیقه‌های تخمینی تماشا، تعداد بازدیدها (یک معیار ویدیوی انبوه )، بازدیدهای فهرست پخش (یک معیار در فهرست پخش )، و بازدیدها در هر شروع فهرست پخش برای یک فهرست پخش خاص را بازیابی می‌کند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته PLAYLIST_ID در مقدار پارامتر filters را با شناسه لیست پخش برای یک لیست پخش در کانال کاربر تأیید شده جایگزین کنید.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

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

10 برتر - لیست های پخش پربیننده برای یک کانال

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

توجه: از آنجایی که این گزارش از بعد playlist استفاده می کند، باید مقداری برای پارامتر درخواست sort مشخص کنید و همچنین پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews

مبتنی بر زمان

گزارش های تصویری

معیارهای زمان تماشای روزانه برای ویدیوهای یک کانال

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

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

معیارهای حاشیه نویسی روزانه برای ویدیوهای یک کانال

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

گزارش لیست پخش

بازدید از لیست پخش روزانه برای یک کانال

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

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

جغرافیایی

گزارش های تصویری

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

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

معیارهای حاشیه نویسی خاص کشور برای ویدیوهای یک کانال

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

معیارهای ویژه استان برای ایالت های ایالات متحده و واشنگتن دی سی

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

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 فیلم برتر - پربازدیدترین ویدیوها در یک کشور خاص

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

توجه: این گزارش از شما می‌خواهد که مقداری برای پارامتر درخواست sort مشخص کنید و پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل بازدیدها

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

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل بازدیدها برای هر نوع محتوا

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

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل زمان تماشا

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

10 فیلم برتر - پربازدیدترین ویدیو در اروپا

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

توجه: این گزارش از شما می‌خواهد که مقداری برای پارامتر درخواست sort مشخص کنید و پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

گزارش لیست پخش

معیارهای زمان تماشای خاص کشور برای لیست‌های پخش کانال

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

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

10 لیست برتر - شروع ترین لیست های پخش در ایالات متحده

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

توجه: از آنجایی که این گزارش از بعد playlist استفاده می کند، باید مقداری برای پارامتر درخواست sort مشخص کنید و همچنین پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

محل پخش

گزارش های تصویری

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

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

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

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

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

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

10 برتر – سایت های شخص ثالثی که بیشترین بازدید را برای یک ویدیوی جاسازی شده ایجاد می کنند

این درخواست تعداد بازدیدها و زمان تخمینی تماشای یک ویدیو یا گروهی از ویدیوها را بازیابی می‌کند. نتایج توسط سایت شخص ثالثی که ویدیو در آن جاسازی شده است گروه بندی می شود. نتایج به ترتیب نزولی بر اساس تعداد بازدید مرتب شده اند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته VIDEO_ID در مقدار پارامتر filters را با لیستی از یک یا چند شناسه ویدیویی جدا شده با کاما برای ویدیوهای آپلود شده خود جایگزین کنید.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

گزارش لیست پخش

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

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

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

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

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

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

جزئیات پخش

گزارش های تصویری

لایک و نپسندیدن بر اساس نوع محتوا

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

dimensions=creatorContentType
metrics=likes,dislikes

منبع ترافیک

گزارش های تصویری

تعداد بازدید و زمان تماشا از منابع مختلف ترافیک در یک کشور

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

تعداد مشاهده روزانه و زمان تماشا از منابع مختلف ترافیک

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

10 مورد برتر - عبارات جستجوی YouTube که بیشترین ترافیک را برای یک ویدیو ایجاد می کنند

این پرس و جو 10 عبارت جستجویی را که بیشترین بازدید را از نتایج جستجوی YouTube برای یک یا چند ویدیو خاص داشته اند، بازیابی می کند. نتایج بر اساس تعداد بازدید به ترتیب نزولی مرتب شده اند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته VIDEO_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه ویدیو جایگزین کنید.

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

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 برتر – وب سایت های خارجی که بیشترین ترافیک را برای یک ویدیو ایجاد می کنند

این پرس و جو 10 وب سایت خارجی را که بیشترین بازدید را برای یک ویدیو یا گروهی از ویدیوها ایجاد کرده اند، بازیابی می کند. نتایج بر اساس زمان تخمینی تماشا به ترتیب نزولی مرتب شده‌اند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته VIDEO_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه ویدیو برای ویدیوهای آپلود شده خود جایگزین کنید.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

گزارش لیست پخش

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

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

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

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

دستگاه / سیستم عامل

گزارش های تصویری

معیارهای روزانه نوع دستگاه برای سیستم عامل اندروید

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

معیارهای سیستم عامل روزانه برای دستگاه های تلفن همراه

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

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

سیستم عامل روزانه و معیارهای نوع دستگاه

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

گزارش لیست پخش

معیارهای روزانه نوع دستگاه برای نمایش لیست پخش در سیستم عامل Android

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

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

معیارهای سیستم عامل روزانه برای نمایش لیست پخش در دستگاه های تلفن همراه

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

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

جمعیت شناختی

گزارش های تصویری

جمعیت شناسی بینندگان در کالیفرنیا (گروه سنی و جنسیت)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

گزارش لیست پخش

جمعیت شناسی بینندگان لیست پخش در کالیفرنیا (گروه سنی و جنسیت)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

اجتماعی

معیارهای اشتراک‌گذاری، جمع‌آوری‌شده بر اساس سرویسی که ویدیوها در آن به اشتراک گذاشته شده‌اند

این درخواست تعداد دفعاتی را که کاربران از دکمه Share برای اشتراک‌گذاری ویدیوهای یک کانال استفاده کرده‌اند، بازیابی می‌کند. نتایج با سرویس اشتراک‌گذاری (Google+، Twitter و غیره) جمع‌آوری می‌شوند و به ترتیب نزولی تعداد اشتراک‌گذاری‌ها مرتب می‌شوند.

dimensions=sharingService
metrics=shares
sort=-shares

حفظ مخاطب

معیارهای حفظ مخاطب برای یک ویدیو

این گزارش توانایی یک ویدیو در حفظ مخاطبان خود را می سنجد. گزارش فقط برای یک ویدیو در یک زمان قابل بازیابی است. توجه داشته باشید که برای اجرای این عبارت در APIs Explorer، باید رشته VIDEO_ID در مقدار پارامتر filters را با شناسه ویدیوی یکی از ویدیوهای آپلود شده خود جایگزین کنید. توجه داشته باشید که گزارش‌های حفظ مخاطب از قابلیت تعیین چندین مقدار برای فیلتر video پشتیبانی نمی‌کنند.

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

توجه داشته باشید که داده‌های فیلتر audienceType از 25 سپتامبر 2013 در دسترس است. API داده‌هایی را برای جستارهایی که از فیلتر برای بازیابی داده‌های تاریخ‌های قبلی استفاده می‌کنند، باز نمی‌گرداند. جستارهایی که از فیلتر استفاده نمی کنند برای هیچ تاریخی بعد از 1 ژوئیه 2008 کار می کنند.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

درآمد/تبلیغات

معیارهای درآمد کانال و عملکرد تبلیغات

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

معیارهای درآمد روزانه و عملکرد تبلیغات

این درخواست معیارهای درآمد روزانه و عملکرد تبلیغات کانال را بازیابی می کند.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

معیارهای درآمد و عملکرد تبلیغات خاص کشور

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

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

10 تا - ویدیوهایی با بالاترین درآمد

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

معیارهای عملکرد تبلیغات برای انواع مختلف تبلیغات

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

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

گزارش صاحب محتوا

آمار اولیه

گزارش های تصویری

تعداد کل بازدیدها، زمان تخمینی تماشا و موارد دیگر برای همه محتوای ادعا شده

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

تعداد بازدیدهای خاص کشور (و بیشتر) برای همه ویدیوهای خودآپلود شده

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

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

تعداد کل بازدیدها (و بیشتر) برای همه محتوای شخص ثالث ادعا شده

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

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

تعداد کل بازدیدها (و بیشتر) برای همه محتوای بارگذاری شده توسط خود

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

تعداد کل بازدیدها (و بیشتر) برای همه محتوای ادعا شده و بارگذاری شده توسط خود

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

10 مورد برتر – پربازدیدترین ویدیوها برای صاحب محتوا

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

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

10 مورد برتر – پربیننده ترین ویدیوها برای صاحب محتوا

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

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

10 مورد برتر – ویدیوهای پربازدید برای کانال صاحب محتوا

این جستجو 10 ویدیوی پربازدید را برای یک کانال خاص یا گروهی از کانال‌هایی که مالک محتوا مدیریت می‌کند، بازیابی می‌کند. نتایج بر اساس تعداد بازدید به ترتیب نزولی مرتب شده اند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته CHANNEL_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

10 برتر – نرخ کلیک حاشیه نویسی برای ویدیوهای کانال که بیشترین بازدید را داشته است

این درخواست تعداد بازدیدها، نرخ کلیک حاشیه نویسی، نرخ بسته شدن حاشیه نویسی، و نمایش حاشیه نویسی را برای 10 ویدیوی پربازدید در یک کانال یا گروهی از کانال های مشخص بازیابی می کند. نتایج بر اساس تعداد بازدیدها به ترتیب نزولی مرتب می‌شوند، به این معنی که ویدیویی که بیشترین بازدید را داشته در ابتدا فهرست می‌شود. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته CHANNEL_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

گزارش لیست پخش

بازدیدهای لیست پخش برای کانال های صاحب محتوا

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

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

آمار برای یک لیست پخش خاص

این درخواست کل شروع‌های فهرست پخش، دقیقه‌های تخمینی تماشا، تعداد بازدیدها (یک معیار ویدیوی انبوه )، بازدیدهای فهرست پخش (یک معیار در فهرست پخش )، و بازدیدها در هر شروع فهرست پخش برای یک فهرست پخش خاص را بازیابی می‌کند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته PLAYLIST_ID در مقدار پارامتر filters را با شناسه لیست پخش برای لیست پخش در یکی از کانال های مالک محتوا جایگزین کنید.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

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

مبتنی بر زمان

گزارش های تصویری

معیارهای زمان تماشای روزانه برای محتوای بارگذاری شده توسط خود

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

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

معیارهای حاشیه نویسی برای محتوای ادعا شده

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

گزارش لیست پخش

بازدیدهای روزانه فهرست پخش برای صاحب محتوا

این درخواست معیارهایی را برای تعامل روزانه کاربر با ویدیوهای موجود در لیست پخش مالک محتوا بازیابی می کند. معیارهای بازیابی شده در گزارش عبارتند از: playlistViews ، playlistStarts ، playlistEstimatedMinutesWatched ، و viewsPerPlaylistStart . همه این معیارها معیارهای درون لیست پخش هستند. از آنجایی که تمام معیارهای درخواستی معیارهای درون لیست پخش هستند، نیازی نیست که درخواست شامل فهرست پخش یا فیلتر گروه نیز باشد.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

جغرافیایی

گزارش های تصویری

معیارهای زمان تماشای کشور برای محتوای بارگذاری شده توسط خود

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

معیارهای حاشیه نویسی خاص کشور برای محتوای بارگذاری شده توسط خود

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

معیارهای ویژه استان برای ایالت های ایالات متحده و واشنگتن دی سی

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

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 شهر برتر ایالات متحده بر اساس کل بازدیدها

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

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل بازدیدها برای هر نوع محتوا

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

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل زمان تماشا

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

10 فیلم برتر - پربیننده ترین ویدیو در اروپا

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

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

گزارش لیست پخش

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

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

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

10 لیست برتر - شروع ترین لیست های پخش در ایالات متحده

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

توجه: از آنجایی که این گزارش از بعد playlist استفاده می کند، باید مقداری برای پارامتر درخواست sort مشخص کنید و همچنین پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

جزئیات پخش

گزارش های تصویری

لایک و نپسندیدن بر اساس نوع محتوا

این پرس و جو تعداد لایک ها و نپسندیدن ها را برای هر نوع محتوا در یک کانال خاص یا گروهی از کانال ها بازیابی می کند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته CHANNEL_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

محل پخش

گزارش های تصویری

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

این پرس و جو تعداد بازدیدها و زمان تخمینی تماشای ویدیوهای آپلود شده در یک کانال خاص یا گروهی از کانال ها را بازیابی می کند. نتایج بر اساس نوع صفحه یا برنامه‌ای که در آن پخش ویدیو انجام شده است جمع‌آوری می‌شوند و نتایج بر اساس تعداد بازدیدها به ترتیب نزولی مرتب می‌شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته CHANNEL_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

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

این پرس و جو تعداد بازدیدهای روزانه و زمان تخمینی تماشا در ایالات متحده را برای ویدیوهای آپلود شده در یک کانال خاص یا گروهی از کانال ها بازیابی می کند. نتایج بر اساس روز برای هر نوع صفحه یا برنامه ای که در آن پخش ویدیو انجام شده است، گروه بندی می شوند. نتایج به ترتیب زمانی معکوس مرتب شده اند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته CHANNEL_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

10 برتر – سایت های شخص ثالثی که بیشترین بازدید را برای یک ویدیوی جاسازی شده ایجاد می کنند

این درخواست تعداد بازدیدها و زمان تخمینی تماشای یک ویدیو یا گروهی از ویدیوها را بازیابی می‌کند. نتایج توسط سایت شخص ثالثی که ویدیو در آن جاسازی شده است گروه بندی می شود. نتایج به ترتیب نزولی بر اساس تعداد بازدید مرتب شده اند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه ویدیویی برای فیلم های بارگذاری شده خود جایگزین کنید.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

گزارش های لیست پخش

نمایش لیست پخش و زمان تماشای مکان های مختلف پخش

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

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

نمایش لیست پخش و زمان تماشای مکان های مختلف پخش

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

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

منبع ترافیک

گزارش های ویدیویی

نمای و زمان تماشای منابع مختلف ترافیک

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

نمای روزانه و زمان تماشای منابع مختلف ترافیک

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

توجه: دو گزارش نمونه بعدی فقط برای منابع ترافیکی خاص پشتیبانی می شوند. VIDEO_REMIXES ، NOTIFICATION ، END_SCREEN ، CAMPAIGN_CARD ، VIDEO_REMIXES و منابع ترافیکی NO_LINK_EMBEDDED برخی از موارد پشتیبانی نشده هستند.

10 مورد برتر - اصطلاحات جستجوی YouTube که بیشترین ترافیک را برای یک فیلم ایجاد می کند

این پرس و جو 10 اصطلاح جستجو را که بیشترین بازدید را از نتایج جستجوی YouTube برای یک فیلم یا گروه خاص از فیلم ها ایجاد می کند ، بازیابی می کند. نتایج با تعداد نمای در ترتیب نزولی طبقه بندی می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه ویدیویی برای فیلم های بارگذاری شده خود جایگزین کنید.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 وب سایت برتر - وب سایت های خارجی که بیشترین ترافیک را برای یک فیلم ایجاد می کنند

این پرس و جو ، 10 وب سایت خارجی را که بیشترین بازدید را از نتایج جستجوی Google برای یک فیلم یا گروه خاص از فیلم ایجاد کرده اند ، بازیابی می کند. نتایج توسط زمان ساعت برآورد شده به ترتیب نزولی طبقه بندی می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه ویدیویی برای فیلم های بارگذاری شده خود جایگزین کنید.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

گزارش های لیست پخش

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

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

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

نمایش لیست پخش و زمان تماشای منابع مختلف ترافیک

این درخواست نماهای لیست پخش ، لیست پخش را بازیابی می کند ، و لیست پخش زمان تماشای لیست های پخش در یک یا چند کانال صاحب محتوا را تخمین می زند. معیارها توسط منبع ترافیک جمع می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String CHANNEL_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

دستگاه/سیستم عامل

گزارش های ویدیویی

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

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

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

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

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

سیستم عامل روزانه و معیارهای نوع دستگاه

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

گزارش های لیست پخش

معیارهای نوع دستگاه برای نمایش لیست پخش در سیستم عامل Android

این پرس و جو ، تعداد پخش لیست پخش و لیست پخش را در دستگاه های اندرویدی برای لیست های پخش در یک یا چند کانال صاحب محتوا بازیابی می کند. نتایج برای هر نوع دستگاهی که در آن مشاهده لیست پخش رخ داده است ، بازگردانده می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String CHANNEL_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

معیارهای سیستم عامل برای نمایش لیست پخش در دستگاه های تلفن همراه

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

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

جمعیت شناختی

گزارش های ویدیویی

جمعیت شناسی بیننده در کالیفرنیا (گروه سنی و جنسیت)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

اجتماعی

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

این درخواست تعداد دفعاتی را که کاربران از دکمه Share برای به اشتراک گذاشتن فیلم هایی که صاحب محتوا بارگذاری کرده است ، بازیابی می کند. نتایج با اشتراک سرویس (Google+ ، توییتر و غیره) جمع می شوند و به ترتیب نزولی تعداد سهام طبقه بندی می شوند.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

حفظ مخاطب

معیارهای حفظ مخاطب برای یک فیلم

این گزارش توانایی یک فیلم در حفظ مخاطبان خود را اندازه گیری می کند. این گزارش فقط می تواند برای یک فیلم واحد به طور همزمان بازیابی شود. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با شناسه ویدیویی برای یکی از فیلم های بارگذاری شده خود جایگزین کنید. توجه داشته باشید که گزارش های حفظ مخاطب از توانایی مشخص کردن مقادیر مختلف برای فیلتر video پشتیبانی نمی کند.

در این مثال ، این گزارش از فیلتر audienceType برای محدود کردن پاسخ استفاده می کند به طوری که فقط حاوی داده هایی برای نمایش های ارگانیک است که نتیجه یک عمل مستقیم کاربر است ، مانند جستجوی یک فیلم یا کلیک بر روی یک فیلم پیشنهادی. به این ترتیب ، این گزارش شامل داده هایی برای بازدید از تبلیغات TrueView in-Stream یا TrueView در داخل نمایشگاه نیست. می توانید فیلتر را برای بازیابی داده های حفظ مخاطبان فیلم از انواع مخاطبان حذف کنید.

توجه داشته باشید که داده های مربوط به فیلتر audienceType از 25 سپتامبر 2013 در دسترس است. API داده هایی را برای نمایش داده شده هایی که از فیلتر استفاده می کنند برای بازیابی داده ها از تاریخ های قبلی باز نمی گرداند. نمایش داده شده هایی که از کار فیلتر برای هر تاریخ پس از 1 ژوئیه 2008 استفاده نمی کنند.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

درآمد/تبلیغات

معیارهای درآمد و عملکرد AD برای محتوای ادعا شده

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

درآمد روزانه و معیارهای عملکرد AD

این درخواست درآمد روزانه و عملکرد عملکرد تبلیغات را برای محتوای ادعا شده صاحب محتوا بازیابی می کند.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

معیارهای مربوط به درآمد و عملکرد تبلیغاتی کشور

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

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

10 - فیلم های برتر با بالاترین درآمد

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

معیارهای عملکرد تبلیغاتی برای انواع مختلف تبلیغات

این درخواست معیارهای عملکرد AD را برای محتوای ادعا شده صاحب محتوا بازیابی می کند. نتایج بر اساس نوع AD گروه بندی می شوند ، که به شما امکان می دهد مقادیر درآمد و CPM را در انواع مختلف تبلیغ مقایسه کنید.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

،

در این صفحه نمونه درخواست های API API YouTube نشان داده شده است. هر مثال به طور خلاصه گزارش را بازیابی می کند و سپس dimensions ، metrics ، filters و sort پارامتر را نشان می دهد. ( گزارش های کانال و صاحب محتوا گزارش می دهد اسناد گزارش هایی را که API از آن پشتیبانی می کند ، مشخص می کند.

هر مثال با مقادیر نشان داده شده به Google APIS Explorer پیوند می زند و جمع می کند. نمونه ها همچنین از تاریخ شروع و پایان پیش فرض ( YYYY-MM-DD ) از 2023-09-01 و 2024-03-31 استفاده می کنند.

پس از پیوند به APIS Explorer ، هنوز هم باید کانال یا صاحب محتوا را که برای آن گزارش می دهید مشخص کنید. APIS Explorer بسته به پرس و جو مورد نظر شما ، مقدار پارامتر ids را با هر دو channel==MINE یا contentOwner==CONTENT_OWNER_ID جمع می کند. برای گزارش های کانال ، می توانید MINE به شناسه کانال کاربر تأیید شده تغییر دهید. برای گزارش های صاحب محتوا ، شما باید CONTENT_OWNER_ID با شناسه صاحب محتوای خود جایگزین کنید.

شما همچنین باید به عنوان کانال مشخص شده یا صاحب محتوا تأیید شوید تا APIS Explorer بتواند درخواست های API شما را با استفاده از OAuth 2.0 مجاز کند.

1. مرتب سازی درخواست ها با ابعاد/معیارهای مختلف
2. گزارش های کانال
3. گزارش های صاحب محتوا

مرتب سازی درخواست ها با ابعاد/معیارهای مختلف

API از توانایی مرتب سازی داده های پاسخ با استفاده از ابعاد یا معیارهای مختلف پشتیبانی می کند. به عنوان مثال ، درخواست زیر داده های منبع ترافیک روزانه را برای فیلم های یک کانال خاص بازیابی می کند. هر ردیف در مجموعه نتیجه تعداد نماهای و زمان برآورد شده ساعت را که از یک نوع خاص از منبع ترافیک (به عنوان مثال EXT_URL ) در یک روز خاص سرچشمه می گیرد ، مشخص می کند.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

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

گزارش های کانال

آمار اولیه

گزارش های ویدیویی

تعداد نمای کل ، زمان تماشای تخمین زده شده و موارد دیگر برای یک کانال

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

نمای خاص کشور (و موارد دیگر) برای یک کانال شمارش می کند

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

10 مورد برتر - بیشتر فیلم های تماشا شده برای یک کانال

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

توجه: این گزارش به شما نیاز دارد تا مقداری را برای پارامتر sort Request مشخص کنید و پارامتر maxResults را بر روی مقدار عدد صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

10 برتر-نرخ کلیک از طریق حاشیه نویسی برای فیلم های مشاهده شده کانال

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

توجه: این گزارش به شما نیاز دارد تا مقداری را برای پارامتر sort Request مشخص کنید و پارامتر maxResults را بر روی مقدار عدد صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

گزارش های لیست پخش

کل نمایش لیست پخش برای یک کانال

این درخواست شروع به بازیابی کل لیست پخش می کند ، دقایقی تخمین زده می شود ، بازدید (یک متریک ویدیویی جمع شده ) ، نمایش لیست پخش (یک متریک لیست در لیست ) ، و نمایش ها در هر لیست پخش برای لیست های پخش در کانال کاربر تأیید شده شروع می شود.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

آمار برای یک لیست پخش خاص

این درخواست شروع به بازیابی کل لیست پخش می کند ، دقایقی تخمین زده می شود ، بازدید (یک متریک ویدیویی جمع شده ) ، نمایش لیست پخش (یک متریک لیست در لیست ) و نمایش ها در هر لیست پخش برای یک لیست پخش خاص شروع می شود. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید رشته PLAYLIST_ID رشته را در مقدار پارامتر filters با شناسه لیست پخش برای لیست پخش در کانال کاربر تأیید شده جایگزین کنید.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

برای بازیابی آمار کل برای لیست های پخش چندگانه ، می توانید لیست PLAYLIST_ID String را با لیست جدا شده کاما از حداکثر 500 لیست پخش برای لیست های پخش در کانال کاربر تأیید شده جایگزین کنید.

10 نفر برتر - بیشتر لیست های پخش شده برای یک کانال

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

توجه: از آنجا که این گزارش از ابعاد playlist استفاده می کند ، باید یک مقدار برای پارامتر sort Request مشخص کنید و همچنین پارامتر maxResults را روی مقدار عدد صحیح 10 یا کمتر تنظیم کنید.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews

مبتنی بر زمان

گزارش های ویدیویی

معیارهای زمان تماشای روزانه برای فیلم های یک کانال

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

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

معیارهای حاشیه نویسی روزانه برای فیلم های یک کانال

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

گزارش های لیست پخش

نمایش لیست پخش روزانه برای یک کانال

این درخواست تعداد نمایش روزانه (یک متریک ویدیویی جمع شده ) ، نمایش لیست پخش (یک متریک لیست در لیست ) ، لیست پخش را شروع می کند ، دقایقی تخمین زده می شود و بازدید در هر لیست پخش برای کانال کاربر تأیید شده شروع می شود. نتایج به ترتیب زمانی طبقه بندی می شوند.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

جغرافیایی

گزارش های ویدیویی

معیارهای ساعت مچی خاص کشور برای فیلم های یک کانال

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

معیارهای حاشیه نویسی خاص کشور برای فیلم های یک کانال

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

معیارهای خاص استان برای ایالات متحده و واشنگتن دی سی

این درخواست بازیابی یک استان توسط پیش بینی تعداد نمای ، دقایقی تخمین زده شده و مدت زمان نمای متوسط ​​برای فیلم های کانال است. این داده ها دولت ایالات متحده را در بر می گیرد و نتایج واشنگتن دی سی توسط کدهای ISO 3166-2 استان ها به صورت الفبایی طبقه بندی می شوند.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 مورد برتر - بیشتر فیلم های مشاهده شده در یک کشور خاص

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

توجه: این گزارش به شما نیاز دارد تا مقداری را برای پارامتر sort Request مشخص کنید و پارامتر maxResults را بر روی مقدار عدد صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده با کل نمای

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

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده با کل بازدید برای هر نوع محتوا

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

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده با کل زمان ساعت

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

10 مورد برتر - بیشتر فیلم های مشاهده شده در اروپا

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

توجه: این گزارش به شما نیاز دارد تا مقداری را برای پارامتر sort Request مشخص کنید و پارامتر maxResults را بر روی مقدار عدد صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

گزارش های لیست پخش

معیارهای ساعت مچی خاص کشور برای لیست های پخش یک کانال

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

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

10 نفر برتر - بیشترین لیست پخش در ایالات متحده

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

توجه: از آنجا که این گزارش از ابعاد playlist استفاده می کند ، باید یک مقدار برای پارامتر sort Request مشخص کنید و همچنین پارامتر maxResults را روی مقدار عدد صحیح 10 یا کمتر تنظیم کنید.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

محل پخش

گزارش های ویدیویی

مشاهده و زمان تماشای از مکانهای مختلف پخش

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

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

نمای روزانه و زمان تماشای مکانهای مختلف پخش را تماشا می کند

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

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

10 سایت برتر-سایت های شخص ثالث که بیشترین دیدگاه ها را برای یک فیلم تعبیه شده ایجاد می کنند

این پرس و جو بازیابی تعداد مشاهده و زمان تماشای تخمین زده شده برای یک فیلم خاص یا گروهی از فیلم ها را بازیابی می کند. نتایج توسط سایت شخص ثالث که در آن فیلم تعبیه شده است ، گروه بندی می شوند. نتایج به ترتیب نزولی با تعداد مشاهده طبقه بندی می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از یک یا چند شناسه ویدیویی برای فیلم های بارگذاری شده خود جایگزین کنید.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

گزارش های لیست پخش

نمایش لیست پخش و زمان تماشای مکان های مختلف پخش

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

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

نمایش لیست پخش روزانه و زمان تماشای مکان های مختلف پخش

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

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

جزئیات پخش

گزارش های ویدیویی

دوست دارد و از نوع محتوا دوست ندارد

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

dimensions=creatorContentType
metrics=likes,dislikes

منبع ترافیک

گزارش های ویدیویی

نمای و تماشای زمان از منابع مختلف ترافیک در یک کشور

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

نمای روزانه و زمان تماشای منابع مختلف ترافیک

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

10 مورد برتر - اصطلاحات جستجوی YouTube که بیشترین ترافیک را برای یک فیلم ایجاد می کند

این پرس و جو 10 اصطلاح جستجوی را که بیشترین بازدید را از نتایج جستجوی YouTube برای یک یا چند فیلم خاص ایجاد می کند ، بازیابی می کند. نتایج با تعداد نمای در ترتیب نزولی طبقه بندی می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از حداکثر 500 شناسه ویدیویی جایگزین کنید.

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

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 وب سایت برتر - وب سایت های خارجی که بیشترین ترافیک را برای یک فیلم ایجاد می کنند

این پرس و جو ، 10 وب سایت خارجی را که بیشترین بازدید را برای یک فیلم یا گروه خاص از فیلم ایجاد کرده اند ، بازیابی می کند. نتایج توسط زمان ساعت برآورد شده به ترتیب نزولی طبقه بندی می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه ویدیویی برای فیلم های بارگذاری شده خود جایگزین کنید.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

گزارش های لیست پخش

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

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

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

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

دستگاه/سیستم عامل

گزارش های ویدیویی

معیارهای نوع دستگاه روزانه برای سیستم عامل Android

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

معیارهای سیستم عامل روزانه برای دستگاه های تلفن همراه

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

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

سیستم عامل روزانه و معیارهای نوع دستگاه

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

گزارش های لیست پخش

معیارهای نوع دستگاه روزانه برای نمایش لیست پخش در سیستم عامل Android

این پرس و جو نماهای روزانه (یک متریک ویدیویی جمع شده ) ، نمایش لیست پخش (یک متریک لیست در لیست ) و زمان تماشای در دستگاه های Android را برای لیست های پخش یک کانال خاص بازیابی می کند. نتایج به صورت روز برای هر نوع دستگاهی که در آن لیست پخش در آن رخ داده است ، گروه بندی می شوند. نتایج به ترتیب زمانی طبقه بندی می شوند.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

معیارهای سیستم عامل روزانه برای نمایش لیست پخش در دستگاه های تلفن همراه

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

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

جمعیت شناختی

گزارش های ویدیویی

جمعیت شناسی بیننده در کالیفرنیا (گروه سنی و جنسیت)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

گزارش های لیست پخش

جمعیتی بیننده لیست پخش در کالیفرنیا (گروه سنی و جنسیت)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

اجتماعی

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

این درخواست تعداد دفعاتی را که کاربران از دکمه Share برای به اشتراک گذاشتن فیلم های کانال استفاده می کنند ، بازیابی می کند. نتایج با اشتراک سرویس (Google+ ، توییتر و غیره) جمع می شوند و به ترتیب نزولی تعداد سهام طبقه بندی می شوند.

dimensions=sharingService
metrics=shares
sort=-shares

حفظ مخاطب

معیارهای حفظ مخاطب برای یک فیلم

این گزارش توانایی یک فیلم در حفظ مخاطبان خود را اندازه گیری می کند. این گزارش فقط می تواند برای یک فیلم واحد به طور همزمان بازیابی شود. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با شناسه ویدیویی برای یکی از فیلم های بارگذاری شده خود جایگزین کنید. توجه داشته باشید که گزارش های حفظ مخاطب از توانایی مشخص کردن مقادیر مختلف برای فیلتر video پشتیبانی نمی کند.

در این مثال ، این گزارش از فیلتر audienceType برای محدود کردن پاسخ استفاده می کند به طوری که فقط حاوی داده هایی برای نمایش های ارگانیک است که نتیجه یک عمل مستقیم کاربر است ، مانند جستجوی یک فیلم یا کلیک بر روی یک فیلم پیشنهادی. به این ترتیب ، این گزارش شامل داده هایی برای بازدید از تبلیغات TrueView in-Stream یا TrueView در داخل نمایشگاه نیست. می توانید فیلتر را برای بازیابی داده های حفظ مخاطبان فیلم از انواع مخاطبان حذف کنید.

توجه داشته باشید که داده های مربوط به فیلتر audienceType از 25 سپتامبر 2013 در دسترس است. API داده هایی را برای نمایش داده شده هایی که از فیلتر استفاده می کنند برای بازیابی داده ها از تاریخ های قبلی باز نمی گرداند. نمایش داده شده هایی که از کار فیلتر برای هر تاریخ پس از 1 ژوئیه 2008 استفاده نمی کنند.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

درآمد/تبلیغات

درآمد کانال و معیارهای عملکرد AD

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

درآمد روزانه و معیارهای عملکرد AD

این درخواست درآمد روزانه یک کانال و معیارهای عملکرد AD را بازیابی می کند.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

معیارهای مربوط به درآمد و عملکرد تبلیغاتی کشور

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

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

10 - فیلم های برتر با بالاترین درآمد

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

معیارهای عملکرد تبلیغاتی برای انواع مختلف تبلیغات

این درخواست معیارهای عملکرد AD را برای محتوای ادعا شده صاحب محتوا بازیابی می کند. نتایج بر اساس نوع AD گروه بندی می شوند ، که به شما امکان می دهد مقادیر درآمد و CPM را در انواع مختلف تبلیغ مقایسه کنید.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

گزارش های صاحب محتوا

آمار اولیه

گزارش های ویدیویی

تعداد نمای کل ، زمان ساعت برآورد شده و بیشتر برای همه مطالب ادعا شده

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

تعداد نمایش های خاص کشور (و موارد دیگر) برای همه فیلم های خود بارگیری

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

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

تعداد کل (و موارد دیگر) برای همه مطالب شخص ثالث مطرح شده است

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

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

تعداد نمای کل (و موارد دیگر) برای همه محتوای خود بارگیری شده است

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

تعداد کل (و موارد دیگر) برای همه مطالب ادعا شده و خود بارگیری می شود

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

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

10 مورد برتر - بیشتر فیلم های مشاهده شده برای یک صاحب محتوا

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

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

10 مورد برتر - بیشتر فیلم های تماشا شده برای یک صاحب محتوا

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

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

10 مورد برتر - بیشتر فیلم های مشاهده شده برای کانال صاحب محتوا

این پرس و جو 10 فیلم مشاهده شده را برای یک کانال خاص یا گروهی از کانال هایی که صاحب محتوا مدیریت می کند ، بازیابی می کند. نتایج با تعداد نمای در ترتیب نزولی طبقه بندی می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String CHANNEL_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

10 برتر-نرخ کلیک از طریق حاشیه نویسی برای فیلم های مشاهده شده کانال

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the 10 most viewed videos in a specified channel or group of channels. Results are sorted by view count in descending order, which means that the most viewed video will be listed first. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Playlist reports

Playlist views for a content owner's channels

This request retrieves total playlist starts, playlist estimated minutes watched, playlist views, and views per playlist start for playlists in the content owner's channels. The playlistViews metric counts only video views that occurred in the context of a playlist. Since all of the requested metrics are in-playlist metrics, the request does not also need to include the playlist or group filter.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for a specific playlist. Note that to run this query in the APIs Explorer, you must replace the string PLAYLIST_ID in the filters parameter value with the playlist ID for a playlist in one of the content owner's channels.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string PLAYLIST_ID with a comma-separated list of up to 500 playlists IDs for playlists in the content owner's channels.

مبتنی بر زمان

Video reports

Daily watch time metrics for self-uploaded content

This query retrieves daily watch time metrics, as well as view counts, monetized playback counts, and impression counts for videos that the content owner uploaded. The report returns one row of data for each day in the requested date range, and rows are sorted in chronological order.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Annotation metrics for claimed content

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's claimed content. Results are sorted in chronological order.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Playlist reports

Daily playlist views for a content owner

This request retrieves metrics for daily user interactions with videos in the content owner's playlists. The metrics retrieved in the report are playlistViews , playlistStarts , playlistEstimatedMinutesWatched , and viewsPerPlaylistStart . All of these metrics are in-playlist metrics. Since all of the requested metrics are in-playlist metrics, the request does not need to also include the playlist or group filter.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

جغرافیایی

Video reports

Country-specific watch time metrics for self-uploaded content

This query retrieves view counts, watch time metrics, and estimated ad revenue for each country. The metrics are for videos that the content owner uploaded. The report returns one row of data for each country where the videos were watched, and rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Country-specific annotation metrics for self-uploaded content

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's uploaded videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Province-specific metrics for US states and Washington DC

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the content owner's claimed videos. The data covers US states and Washington DC Results are sorted alphabetically by provinces' ISO 3166-2 codes .

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 US cities by total views

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed videos during the specified date range. The query could be modified to request data for another country by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total views for each content type

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed content during the specified date range for each supported creatorContentType . Results are sorted by view count in descending order.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any US city accounted for the greatest total daily watch time of the content owner's claimed content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Most watched videos in Europe

This query retrieves the 10 most watched videos in Europe, among videos claimed by the content owner, as measured by number of views during the specified date range. The query could be modified to request data for another continent by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Results are sorted by view count in descending order.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Playlist reports

Country-specific watch time metrics for a content owner's playlists

This query retrieves country-specific playlist view counts and playlist watch time metrics for all playlists in the content owner's channels. The report returns one row of data for each country where the playlists were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 – Most started playlists in the United States

This query retrieves the 10 playlists from the content owner's channels that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set th maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Playback details

Video reports

Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a particular channel or group of channels. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Playback location

Video reports

Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for videos uploaded to a particular channel or group of channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for videos uploaded to a particular channel or group of channels. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in reverse chronological order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of playlist views, playlist estimated watch time, and playlist starts for all playlists in a content owner's channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, playlist view counts, and playlist estimated watch time in the United States for all playlists in a content owner's channels. Results are returned for each type of page or application where playlist views occurred.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

منبع ترافیک

Video reports

Viewcounts and watch time from different traffic sources

This request retrieves the number of views and estimated watch time for the content owner's videos. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the content owner's videos. The metrics are aggregated on a daily basis by traffic source and sorted in reverse chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Note: The next two sample reports are only supported for specific traffic sources. VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES , and NO_LINK_EMBEDDED traffic sources are some of the unsupported ones.

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for a specific video or group of videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views from Google search results for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of playlist views, playlist starts, and playlist estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Playlist view counts and watch time from different traffic sources

This request retrieves playlist views, playlist starts, and playlist estimated watch time for playlists in one or more of a content owner's channels. The metrics are aggregated by traffic source. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Device/OS

Video reports

Daily device type metrics for claimed videos

This query retrieves daily view counts and estimated watch time by device type for videos claimed by a particular content owner. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Daily operating system metrics for claimed videos viewed on mobile devices

This query retrieves daily view counts and estimated watch time by operating system for views of videos claimed by a specified content owner that took place on mobile devices. Results are grouped by day for each operating system where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for videos claimed by a particular content owner. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Device type metrics for playlist views on the Android operating system

This query retrieves playlist view counts and playlist estimated watch time on Android devices for playlists in one or more of a content owner's channels. Results are returned for each type of device where playlist views occurred. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Operating system metrics for playlist views on mobile devices

This query retrieves playlist view counts and playlist estimated watch time on mobile devices for playlists in any of a content owner's channels. Results are returned for each operating system on which playlist views occurred.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

جمعیت شناختی

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the content owner's claimed content. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

اجتماعی

Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the Share button to share videos that the content owner uploaded. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

حفظ مخاطب

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Revenue/Ads

Revenue and ad performance metrics for claimed content

This request retrieves revenue and ad performance metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Daily revenue and ad performance metrics

This request retrieves daily revenue and ad performance metrics for the content owner's claimed content.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Country-specific revenue and ad performance metrics

This request retrieves country-specific revenue and ad performance metrics for the content owner's claimed content. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest estimated revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the 10 videos that where claimed by the content owner claimed and that had the highest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

،

This page shows sample YouTube Analytics API requests. Each example briefly describes the report being retrieved and then shows the corresponding dimensions , metrics , filters , and sort parameter values. (The channel reports and content owner reports documents identify the reports that the API supports.)

Each example links to and populates the Google APIs Explorer with the values shown. The examples also use default start and end dates ( YYYY-MM-DD ) of 2023-09-01 and 2024-03-31 .

After linking to the APIs Explorer, you must still specify the channel or content owner for which you are retrieving reports. The APIs Explorer will populate the ids parameter value with either channel==MINE or contentOwner==CONTENT_OWNER_ID , depending on the query that you have clicked. For channel reports, you could change MINE to the authenticated user's channel ID. For content owner reports, you need to replace CONTENT_OWNER_ID with your content owner ID.

You also have to be authenticated as the specified channel or content owner so that the APIs Explorer can authorize your API requests using OAuth 2.0 .

1. Sorting requests by multiple dimensions/metrics
2. Channel reports
3. Content owner reports

Sorting requests by multiple dimensions/metrics

The API supports the ability to sort response data using multiple dimensions or metrics. For example, the request below retrieves daily traffic source data for a particular channel's videos. Each row in the result set identifies the number of views and the estimated watch time that originated from a particular type of traffic source (eg EXT_URL ) on a particular day.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

In the response, results are sorted chronologically. Within the set of results for each day, results are sorted in descending order by view count. So, the first row in the result set contains data for the traffic source that generated the most views on the first day in the requested date range. The second row contains data for the traffic source that generated the next highest number of views on the first day.

Channel reports

آمار اولیه

Video reports

Total view counts, estimated watch time, and more for a channel

This query retrieves aggregated metrics for the channel's content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Country-specific view counts (and more) for a channel

This query retrieves metrics for a specific country for a channel's videos. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

Top 10 – Most watched videos for a channel

This query retrieves a channel's 10 most watched videos, as measured by estimated minutes watched during the specified date range. Results are sorted by estimated minutes watched in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

Top 10 – Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's 10 most viewed videos. Results are sorted by view count in descending order, which means that the most viewed video will be listed first.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Playlist reports

Total playlist views for a channel

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for playlists in the authenticated user's channel.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for a specific playlist. Note that to run this query in the APIs Explorer, you must replace the string PLAYLIST_ID in the filters parameter value with the playlist ID for a playlist in the authenticated user's channel.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string PLAYLIST_ID with a comma-separated list of up to 500 playlists IDs for playlists in the authenticated user's channel.

Top 10 – Most watched playlists for a channel

This query retrieves a channel's 10 most watched playlists, as measured by playlist views during the specified date range. It also retrieves several other playlist metrics, such as the number of times that viewers initiated playback of each playlist and the average amount of time that a viewer watched videos in the playlist after it was started. Results are sorted by playlist views in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set the maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews

مبتنی بر زمان

Video reports

Daily watch time metrics for a channel's videos

This query retrieves daily view counts, watch time metrics, and new subscriber counts for a channel's videos. The report returns one row of data for each day in the requested date range. Rows are sorted in chronological order.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Daily annotation metrics for a channel's videos

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's content. Results are sorted in chronological order.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Playlist reports

Daily playlist views for a channel

This request retrieves daily view counts (an aggregated video metric ), playlist views (an in-playlist metric), playlist starts, estimated minutes watched, and views per playlist start for the authenticated user's channel. Results are sorted in chronological order.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

جغرافیایی

Video reports

Country-specific watch time metrics for a channel's videos

This query retrieves country-specific view counts, watch time metrics, and subscription figures for a channel's videos. The report returns one row of data for each country where the channel's videos were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Country-specific annotation metrics for a channel's videos

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the channel's videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Province-specific metrics for US states and Washington DC

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the channel's videos. The data covers US states and Washington DC Results are sorted alphabetically by provinces' ISO 3166-2 codes .

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 – Most viewed videos in a specific country

This query retrieves the channel's 10 most viewed videos, as measured by number of views during the specified date range, in a specified country. Results are sorted by view count in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total views

This query retrieves a list of the 10 US cities that accounted for the most views of the channel's content during the specified date range. The query could be modified to request data for another country by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total views for each content type

This query retrieves a list of the 10 US cities that accounted for the most views of the channel's content during the specified date range for each supported creatorContentType . Results are sorted by view count in descending order.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Top 10 US cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any US city accounted for the greatest total daily watch time of the channel's content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Most viewed videos in Europe

This query retrieves the channel's 10 most viewed videos in Europe, as measured by number of views during the specified date range. The query could be modified to request data for another continent by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Results are sorted by view count in descending order.

Note: This report requires you to specify a value for the sort request parameter and to set the maxResults parameter to an integer value of 10 or less.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Playlist reports

Country-specific watch time metrics for a channel's playlists

This query retrieves country-specific view counts (an aggregated video metric ), playlist views (an in-playlist metric), and watch time metrics for a channel's playlists. The report returns one row of data for each country where the channel's playlists were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Top 10 – Most started playlists in the United States

This query retrieves the 10 playlists that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set the maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

Playback location

Video reports

Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for a particular channel's videos. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for a particular channel's videos. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in chronological order.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of one or more video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of view counts (an aggregated video metric ), playlist views (an in-playlist metric), estimated watch time, and playlist starts for a particular channel's playlists. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Daily playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, view counts (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time in the United States for a particular channel's playlists. Results are grouped by day for each type of page or application where playlist views occurred. Results are sorted in chronological order.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

Playback details

Video reports

Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a channel.

dimensions=creatorContentType
metrics=likes,dislikes

منبع ترافیک

Video reports

Viewcounts and watch time from different traffic sources in a country

This request retrieves the number of views and estimated watch time for the channel's videos in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the channel's videos. The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for one or more specific videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs.

For example, you could run the query for a single video or replace VIDEO_ID to identify the search terms that generate the most traffic for that video. You could also list all of the videos in a particular playlist to determine which search terms generate the most traffic for any of the videos in that playlist.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of views (an aggregated video metric ), playlist views (an in-playlist metric), playlist starts, and estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Daily playlist view counts and watch time from different traffic sources

This request retrieves a channel's daily playlist views (an in-playlist metric), playlist starts, and estimated watch time. It also retrieves total views (an aggregated video metric ). The metrics are aggregated on a daily basis by traffic source and sorted in chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Device/OS

Video reports

Daily device type metrics for the Android operating system

This query retrieves daily view counts and estimated watch time on Android devices for a particular channel's videos. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Daily operating system metrics for mobile devices

This query retrieves daily view counts and estimated watch time on mobile devices for a particular channel's videos. Results are grouped by day for each operating system on which video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for a channel. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Daily device type metrics for playlist views on the Android operating system

This query retrieves daily views (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time on Android devices for a particular channel's playlists. Results are grouped by day for each type of device where playlist views occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Daily operating system metrics for playlist views on mobile devices

This query retrieves daily views (an aggregated video metric ), playlist views (an in-playlist metric), and estimated watch time on mobile devices for a particular channel's playlists. Results are grouped by day for each operating system on which playlist views occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

جمعیت شناختی

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the channel's videos. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Playlist reports

Playlist viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the channel's playlists. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

اجتماعی

Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the Share button to share a channel's videos. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

dimensions=sharingService
metrics=shares
sort=-shares

حفظ مخاطب

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Revenue/Ads

Channel revenue and ad performance metrics

This request retrieves a channel's revenue and ad performance metrics. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Daily revenue and ad performance metrics

This request retrieves a channel's daily revenue and ad performance metrics.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Country-specific revenue and ad performance metrics

This request retrieves a channel's country-specific revenue and ad performance metrics. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest net revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the channel's 10 videos with the greatest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Content owner reports

آمار اولیه

Video reports

Total view counts, estimated watch time, and more for all claimed content

This query retrieves aggregated metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Country-specific view counts (and more) for all self-uploaded videos

This query retrieves metrics for a specific country for videos that the content owner uploaded. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Total view counts (and more) for all claimed third-party content

This query retrieves aggregated metrics for videos that the content owner claimed but did not upload. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Total view counts (and more) for all self-uploaded content

This query retrieves aggregated metrics for videos that the content owner uploaded. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Total view counts (and more) for all claimed, self-uploaded content

This query retrieves aggregated metrics for videos that the content owner uploaded and also claimed. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

Top 10 – Most viewed videos for a content owner

This query retrieves the 10 most viewed videos, as measured by number of views during the specified date range, that the content owner uploaded. Results are sorted by view count in descending order.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

Top 10 – Most watched videos for a content owner

This query retrieves the 10 most watched videos, as measured by estimated minutes watched during the specified date range, that the content owner uploaded. Results are sorted by estimated minutes watched in descending order.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

Top 10 – Most viewed videos for a content owner's channel

This query retrieves the 10 most viewed videos for a specific channel or group of channels that the content owner manages. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Top 10 – Annotation click-through rates for a channel's most viewed videos

This request retrieves view counts, annotation click-through rates, annotation close rates, and annotation impressions for the 10 most viewed videos in a specified channel or group of channels. Results are sorted by view count in descending order, which means that the most viewed video will be listed first. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Playlist reports

Playlist views for a content owner's channels

This request retrieves total playlist starts, playlist estimated minutes watched, playlist views, and views per playlist start for playlists in the content owner's channels. The playlistViews metric counts only video views that occurred in the context of a playlist. Since all of the requested metrics are in-playlist metrics, the request does not also need to include the playlist or group filter.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Statistics for a specific playlist

This request retrieves total playlist starts, estimated minutes watched, views (an aggregated video metric ), playlist views (an in-playlist metric), and views per playlist start for a specific playlist. Note that to run this query in the APIs Explorer, you must replace the string PLAYLIST_ID in the filters parameter value with the playlist ID for a playlist in one of the content owner's channels.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

To retrieve aggregate statistics for multiple playlists, you can also replace the string PLAYLIST_ID with a comma-separated list of up to 500 playlists IDs for playlists in the content owner's channels.

مبتنی بر زمان

Video reports

Daily watch time metrics for self-uploaded content

This query retrieves daily watch time metrics, as well as view counts, monetized playback counts, and impression counts for videos that the content owner uploaded. The report returns one row of data for each day in the requested date range, and rows are sorted in chronological order.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Annotation metrics for claimed content

This request retrieves daily view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's claimed content. Results are sorted in chronological order.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Playlist reports

Daily playlist views for a content owner

This request retrieves metrics for daily user interactions with videos in the content owner's playlists. The metrics retrieved in the report are playlistViews , playlistStarts , playlistEstimatedMinutesWatched , and viewsPerPlaylistStart . All of these metrics are in-playlist metrics. Since all of the requested metrics are in-playlist metrics, the request does not need to also include the playlist or group filter.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

جغرافیایی

Video reports

Country-specific watch time metrics for self-uploaded content

This query retrieves view counts, watch time metrics, and estimated ad revenue for each country. The metrics are for videos that the content owner uploaded. The report returns one row of data for each country where the videos were watched, and rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Country-specific annotation metrics for self-uploaded content

This request retrieves country-specific view counts, annotation click-through rates, annotation close rates, and annotation impressions for the content owner's uploaded videos. Results are sorted by annotation click-through rate in descending order, which means that the country with the highest annotation click-through rate will be listed first.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Province-specific metrics for US states and Washington DC

This request retrieves a province-by-province breakdown of view counts, estimated minutes watched, and average view duration for the content owner's claimed videos. The data covers US states and Washington DC Results are sorted alphabetically by provinces' ISO 3166-2 codes .

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 US cities by total views

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed videos during the specified date range. The query could be modified to request data for another country by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Other filters are supported, too. Results are sorted by view count in descending order.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total views for each content type

This query retrieves a list of the 10 US cities that accounted for the most views of the content owner's claimed content during the specified date range for each supported creatorContentType . Results are sorted by view count in descending order.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Top 10 US cities by total watch time

This query retrieves a list of the top 10 days during the specified date range when any US city accounted for the greatest total daily watch time of the content owner's claimed content. The query results identify the total watch time, the date on which the watch time occurred, and the city where the content was estimated to have been viewed. Results are sorted in descending order of total watch time.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – Most watched videos in Europe

This query retrieves the 10 most watched videos in Europe, among videos claimed by the content owner, as measured by number of views during the specified date range. The query could be modified to request data for another continent by choosing another valid value for that filter. Similarly, the query could be modified to retrieve data for a subcontinent, such as Western Europe or Southeastern Asia, by using the subContinent filter and one of its valid values. Results are sorted by view count in descending order.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Playlist reports

Country-specific watch time metrics for a content owner's playlists

This query retrieves country-specific playlist view counts and playlist watch time metrics for all playlists in the content owner's channels. The report returns one row of data for each country where the playlists were watched. Rows are sorted in descending order of number of minutes watched.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 – Most started playlists in the United States

This query retrieves the 10 playlists from the content owner's channels that viewers in the United States started watching most frequently during the specified date range. Results are sorted by number of playlist starts in descending order.

Note: Since this report uses the playlist dimension, you must specify a value for the sort request parameter and also set th maxResults parameter to an integer value of 10 or less.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Playback details

Video reports

Likes and dislikes by content type

This query retrieves the number of likes and dislikes for each type of content on a particular channel or group of channels. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Playback location

Video reports

Viewcounts and watch time from different playback locations

This query retrieves the number of views and estimated watch time for videos uploaded to a particular channel or group of channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Daily view counts and watch time from different playback locations

This query retrieves daily view counts and estimated watch time in the United States for videos uploaded to a particular channel or group of channels. Results are grouped by day for each type of page or application where video playbacks occurred. Results are sorted in reverse chronological order. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 – Third-party sites that generate the most views for an embedded video

This query retrieves view counts and estimated watch time for a particular video or group of videos. Results are grouped by the third-party site where the video was embedded. Results are sorted in descending order by view count. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Playlist reports

Playlist view counts and watch time from different playback locations

This query retrieves the number of playlist views, playlist estimated watch time, and playlist starts for all playlists in a content owner's channels. Results are aggregated based on the type of page or application where video playbacks occurred, and results are sorted in descending order by playlist starts.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Playlist view counts and watch time from different playback locations

This query retrieves daily playlist starts, playlist view counts, and playlist estimated watch time in the United States for all playlists in a content owner's channels. Results are returned for each type of page or application where playlist views occurred.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

منبع ترافیک

Video reports

Viewcounts and watch time from different traffic sources

This request retrieves the number of views and estimated watch time for the content owner's videos. The metrics are aggregated by traffic source, which describes the manner in which users reached the video.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Daily view counts and watch time from different traffic sources

This request retrieves daily view counts and daily estimated watch time for the content owner's videos. The metrics are aggregated on a daily basis by traffic source and sorted in reverse chronological order.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Note: The next two sample reports are only supported for specific traffic sources. VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES , and NO_LINK_EMBEDDED traffic sources are some of the unsupported ones.

Top 10 – YouTube search terms that generate the most traffic for a video

This query retrieves the 10 search terms that generated the most views from YouTube search results for a specific video or group of videos. Results are sorted by view count in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – External websites that generate the most traffic for a video

This query retrieves the 10 external websites that generated the most views from Google search results for a specific video or group of videos. Results are sorted by estimated watch time in descending order. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with a comma-separated list of up to 500 video IDs for your uploaded videos.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Playlist reports

Playlist view counts and watch time from different traffic sources in a country

This request retrieves the number of playlist views, playlist starts, and playlist estimated watch time for playlist views in a specified country. The metrics are aggregated by traffic source, which describes the manner in which users reached the playlist.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Playlist view counts and watch time from different traffic sources

This request retrieves playlist views, playlist starts, and playlist estimated watch time for playlists in one or more of a content owner's channels. The metrics are aggregated by traffic source. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Device/OS

Video reports

Daily device type metrics for claimed videos

This query retrieves daily view counts and estimated watch time by device type for videos claimed by a particular content owner. Results are grouped by day for each type of device where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Daily operating system metrics for claimed videos viewed on mobile devices

This query retrieves daily view counts and estimated watch time by operating system for views of videos claimed by a specified content owner that took place on mobile devices. Results are grouped by day for each operating system where video playbacks occurred. Results are sorted in chronological order.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Daily operating system and device type metrics

This query retrieves daily view counts and estimated watch time for videos claimed by a particular content owner. Statistics are grouped by operating system and device type. Results are sorted in chronological order.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Playlist reports

Device type metrics for playlist views on the Android operating system

This query retrieves playlist view counts and playlist estimated watch time on Android devices for playlists in one or more of a content owner's channels. Results are returned for each type of device where playlist views occurred. Note that to run this query in the APIs Explorer, you must replace the string CHANNEL_ID in the filters parameter value with a comma-separated list of up to 500 channel IDs for your channels.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Operating system metrics for playlist views on mobile devices

This query retrieves playlist view counts and playlist estimated watch time on mobile devices for playlists in any of a content owner's channels. Results are returned for each operating system on which playlist views occurred.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

جمعیت شناختی

Video reports

Viewer demographics in California (age group and gender)

This report retrieves statistics about the age group and gender of viewers in California who watched the content owner's claimed content. Results are sorted by gender and then by age group. This query could be modified to retrieve the same statistics for all viewers worldwide or all viewers in a country, continent, subcontinent, or another US state by adjusting the filters parameter value.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

اجتماعی

Sharing metrics, aggregated by service where videos were shared

This request retrieves the number of times that users used the Share button to share videos that the content owner uploaded. Results are aggregated by sharing service (Google+, Twitter, etc.) and sorted in descending order of number of shares.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

حفظ مخاطب

Audience retention metrics for a video

This report measures a video's ability to retain its audience. The report can only be retrieved for a single video at a time. Note that to run this query in the APIs Explorer, you must replace the string VIDEO_ID in the filters parameter value with the video ID for one of your uploaded videos. Note that audience retention reports do not support the ability to specify multiple values for the video filter.

In this example, the report uses the audienceType filter to restrict the response so that it only contains data for organic views, which are the result of a direct user action, such as a search for a video or a click on a suggested video. As such, the report does not include data for views from TrueView in-stream or TrueView in-display ads. You can remove the filter to retrieve the video's audience retention data from all audience types.

Note that data for the audienceType filter is available as of September 25, 2013. The API will not return data for queries that use the filter to try to retrieve data from earlier dates. Queries that do not use the filter work for any date after July 1, 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Revenue/Ads

Revenue and ad performance metrics for claimed content

This request retrieves revenue and ad performance metrics for the content owner's claimed content. The report returns a single row of data that contains totals for each requested metric during the specified date range.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Daily revenue and ad performance metrics

This request retrieves daily revenue and ad performance metrics for the content owner's claimed content.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Country-specific revenue and ad performance metrics

This request retrieves country-specific revenue and ad performance metrics for the content owner's claimed content. Results are sorted in descending order by revenue amount, which means that the first country listed will be the one where the partner had the greatest estimated revenue.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 – Videos with the highest revenue

This request retrieves revenue and ad performance metrics for the 10 videos that where claimed by the content owner claimed and that had the highest revenue. Results are sorted in descending order by revenue amount, which means that the first video will be the one that had the highest estimated revenue.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Ad performance metrics for different ad types

This request retrieves ad performance metrics for the content owner's claimed content. Results are grouped by ad type, which enables you to compare revenue and CPM values across different ad types.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType