نمونه درخواست های 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

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

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