API 要求範例

本頁提供 YouTube Analytics API 要求範例。每個範例都會簡要說明擷取的報表，然後顯示對應的 dimensions、metrics、filters 和 sort 參數值。(管道報表和內容擁有者報告文件會指出 API 支援的報表)。

每個範例都會連結至 Google APIs Explorer，並填入顯示的值。這些範例也會使用預設開始與結束日期 (YYYY-MM-DD) 2023-09-01 和 2024-03-31 的設定。

連結至 APIs Explorer 後，您還是必須指定要擷取報表的頻道或內容擁有者。視您點選的查詢而定，API Explorer 會將 channel==MINE 或 contentOwner==CONTENT_OWNER_ID 填入 ids 參數值。針對管道報表，您可以將 MINE 變更為已驗證使用者的頻道 ID。如要查閱內容擁有者報告，請將 CONTENT_OWNER_ID 換成您的內容擁有者 ID。

您也必須以指定頻道或內容擁有者的身分進行驗證，讓 APIs Explorer 可以使用 OAuth 2.0 授權您的 API 要求。

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

特定播放清單的統計資料

這項要求會擷取播放清單總開始播放次數、估計觀看時間 (分鐘)、觀看次數 ( 匯總影片指標) 播放清單觀看次數 (播放清單內指標)、 每個播放清單開始播放的次數請注意，如要在 API 中執行這項查詢 檔案總管，您必須替換 filters 中的字串 PLAYLIST_ID 參數值。

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

如要擷取多個播放清單的匯總統計資料，您也可以在通過驗證的使用者頻道上，將字串 PLAYLIST_ID 替換成以半形逗號分隔的清單 (最多包含 500 個播放清單 ID)。

前 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 名城市的總觀看次數

這項查詢會針對所有支援的 creatorContentType，擷取指定日期範圍內的 10 個美國城市，頻道內容獲得最多觀看次數。結果會按觀看次數遞減排序。

    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 大 - 為內嵌影片產生最多觀看次數的第三方網站

這項查詢會擷取特定影片或影片群組的觀看次數和預估觀看時間。搜尋結果會按嵌入影片的第三方網站分組，結果會按觀看次數遞減排序。請注意，如要在 API Explorer 中執行這項查詢，您必須將 filters 參數值中的 VIDEO_ID 字串，替換成逗號分隔的一或多個影片 ID 清單。

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 搜尋字詞

此查詢會擷取為一或多部特定影片的 YouTube 搜尋結果產生最多觀看次數的搜尋字詞。結果會按觀看次數遞減排序。請注意，如要在 API Explorer 中執行這項查詢，您必須將 filters 參數值中的 VIDEO_ID 字串替換成最多 500 個影片 ID 的逗號分隔清單，

舉例來說，您可以查詢單一影片，也可以取代 VIDEO_ID，找出為該影片產生最多流量的搜尋字詞。您也可以列出特定播放清單中的所有影片，找出為該播放清單中的任何影片帶來最多流量的搜尋字詞。

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

前 10 大 - 為影片產生最多流量的外部網站

這項查詢會擷取能為特定影片或一組影片帶來最多觀看次數的 10 個外部網站。搜尋結果是依預估觀看時間遞減排序。請注意，如要在 API Explorer 中執行這項查詢，您必須將 filters 參數值中的 VIDEO_ID 字串替換成以半形逗號分隔的清單，當中最多包含 500 個已上傳影片的影片 ID。

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 作業系統中播放清單觀看次數的每日裝置類型指標

這項查詢會擷取每日觀看次數 ( 匯總影片指標) 播放清單觀看次數 (播放清單內指標)、 以及 YouTube 裝置上所有播放清單的預估觀看時間。搜尋結果為 依照發生播放清單觀看次數的各類型裝置劃分資料。結果會依時間先後順序排序。

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

觀眾續看率

影片的觀眾續看率指標

這份報表會評估影片留住觀眾的能力。系統一次只能擷取單一影片的報表。請注意，若要在 API Explorer 中執行此查詢，您必須將 filters 參數值中的 VIDEO_ID 字串取代為您其中一部影片的影片 ID。請注意，觀眾續看率報表不支援為 video 篩選器指定多個值。

在本例中，報表使用 audienceType 篩選器來限制回應，只納入自然觀看次數的資料，也就是使用者直接動作 (例如搜尋影片或點選推薦影片) 的結果。因此，報表不會納入 TrueView 串流內廣告或 TrueView 多媒體廣告的觀看次數資料。只要移除篩選條件，即可從所有觀眾類型擷取影片的觀眾續看率資料。

請注意，audienceType 篩選器可提供自 2013 年 9 月 25 日起的資料。如果查詢使用篩選器嘗試擷取較早日期的資料，API 就不會傳回資料。不使用這個篩選器的查詢，則會在 2008 年 7 月 1 日後生效。

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

不同廣告類型的廣告成效指標

這項要求會針對內容擁有者已聲明版權的內容，擷取廣告成效指標。結果會按廣告類型分類，方便您比較不同廣告類型的收益和千次曝光出價。

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 中執行這項查詢，您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以半形逗號分隔的清單，當中包含您管道中最多 500 個管道 ID。

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

10 大 – 註解點閱率，頻道觀看次數最多的影片

這項要求會針對指定頻道或群組中 10 名觀看次數最多的影片，擷取觀看次數、註解點閱率、註解關閉率和註解曝光次數。結果會按觀看次數以遞減方式排序，也就是觀看次數最多的影片會最先顯示。請注意，若要在 APIs Explorer 中執行這項查詢，您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以半形逗號分隔的清單，當中包含您管道中最多 500 個管道 ID。

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

播放清單報表

內容擁有者頻道的播放清單觀看次數

這項要求會擷取播放清單開始總次數、播放清單預估觀看分鐘數、播放清單 每個播放清單的觀看次數和觀看次數都會計入內容擁有者頻道上的播放清單觀看次數 「playlistViews」指標只會計算在影片播放期間產生的影片觀看次數 播放清單由於所有要求的指標都是播放清單內指標，因此要求不會 一併加入 playlist 或群組篩選器。

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

特定播放清單的統計資料

這項要求會擷取播放清單總開始播放次數、估計觀看時間 (分鐘)、觀看次數 ( 匯總影片指標) 播放清單觀看次數 (播放清單內指標)、 每個播放清單開始播放的次數請注意，如要在 API 中執行這項查詢 檔案總管，您必須替換 filters 中的字串 PLAYLIST_ID 參數值。

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

如要擷取多個播放清單的匯總統計資料，也可以將字串 PLAYLIST_ID 替換成逗號分隔的清單 (最多 500 個) 適用於內容擁有者頻道的播放清單 ID。

，瞭解如何調查及移除這項存取權。

根據時間

影片報表

自行上傳內容的每日觀看時間指標

這項查詢會擷取每日觀看時間指標、觀看次數、營利播放次數和內容擁有者所上傳影片的曝光次數。報表會針對要求的日期範圍中的每一天傳回一列資料，資料列則以時間順序排列。

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 名城市的總觀看次數

這項查詢會針對所有支援的 creatorContentType，擷取指定日期範圍內的 10 個美國城市，讓內容擁有者的已聲明版權內容獲得最多觀看次數。結果會按觀看次數遞減排序。

    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 中執行這項查詢，您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以半形逗號分隔的清單，當中包含您管道中最多 500 個管道 ID。

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

播放位置

影片報表

來自不同播放位置的觀看次數和觀看時間

這項查詢會擷取上傳至特定頻道或一組頻道的影片觀看次數和預估觀看時間。系統會根據發生影片播放的網頁或應用程式類型匯總結果，並按觀看次數遞減排序結果。請注意，若要在 APIs Explorer 中執行這項查詢，您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以半形逗號分隔的清單，當中包含您管道中最多 500 個管道 ID。

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

每日觀看次數和觀看時間來自不同的播放位置

這項查詢會擷取美國地區或某組頻道上傳影片的每日觀看次數和預估觀看時間。系統會根據發生影片播放的網頁或應用程式類型，按日分組顯示結果。結果會按時間順序由新至舊排序。請注意，若要在 APIs Explorer 中執行這項查詢，您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以半形逗號分隔的清單，當中包含您管道中最多 500 個管道 ID。

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

前 10 大 - 為內嵌影片產生最多觀看次數的第三方網站

這項查詢會擷取特定影片或影片群組的觀看次數和預估觀看時間。搜尋結果會按嵌入影片的第三方網站分組，結果會按觀看次數遞減排序。請注意，如要在 API Explorer 中執行這項查詢，您必須將 filters 參數值中的 VIDEO_ID 字串替換成以半形逗號分隔的清單，當中最多包含 500 個已上傳影片的影片 ID。

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 搜尋字詞

此查詢會擷取從 YouTube 搜尋結果中與特定影片或影片群組產生最多觀看次數的 10 個搜尋字詞。結果會按觀看次數遞減排序。請注意，如要在 API Explorer 中執行這項查詢，您必須將 filters 參數值中的 VIDEO_ID 字串替換成以半形逗號分隔的清單，當中最多包含 500 個已上傳影片的影片 ID。

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

前 10 大 - 為影片產生最多流量的外部網站

此查詢會擷取從 Google 搜尋結果中，針對特定影片或一組影片產生最多觀看次數的外部網站 10 個。搜尋結果是依預估觀看時間遞減排序。請注意，如要在 API Explorer 中執行這項查詢，您必須將 filters 參數值中的 VIDEO_ID 字串替換成以半形逗號分隔的清單，當中最多包含 500 個已上傳影片的影片 ID。

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 中執行這項查詢，您必須將字串 filters 參數值中的 CHANNEL_ID (以半形逗號分隔) 頻道 ID 的清單，最多包含 500 個頻道 ID。

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 作業系統上播放清單觀看次數的裝置類型指標

這項查詢會擷取 YouTube 裝置上的播放清單觀看次數和播放清單的預估觀看時間 播放清單下的播放清單系統會傳回以下項目的結果： 分別產生播放清單觀看次數的每一種裝置。請注意，如要在 API 中執行這項查詢 檔案總管，您必須替換 filters 中的字串 CHANNEL_ID 參數值，並以半形逗號分隔，列出您頻道中最多 500 個管道 ID。

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+、Twitter 等) 彙整，並按分享次數遞減排序。

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

觀眾續看率

影片的觀眾續看率指標

這份報表會評估影片留住觀眾的能力。系統一次只能擷取單一影片的報表。請注意，若要在 API Explorer 中執行此查詢，您必須將 filters 參數值中的 VIDEO_ID 字串取代為您其中一部影片的影片 ID。請注意，觀眾續看率報表不支援為 video 篩選器指定多個值。

在本例中，報表使用 audienceType 篩選器來限制回應，只納入自然觀看次數的資料，也就是使用者直接動作 (例如搜尋影片或點選推薦影片) 的結果。因此，報表不會納入 TrueView 串流內廣告或 TrueView 多媒體廣告的觀看次數資料。只要移除篩選條件，即可從所有觀眾類型擷取影片的觀眾續看率資料。

請注意，audienceType 篩選器可提供自 2013 年 9 月 25 日起的資料。如果查詢使用篩選器嘗試擷取較早日期的資料，API 就不會傳回資料。不使用這個篩選器的查詢，則會在 2008 年 7 月 1 日後生效。

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

收益/廣告

已聲明版權內容的收益和廣告成效指標

針對已聲明版權的內容，這項要求會擷取其收益和廣告成效指標。報表會傳回一列資料，其中包含指定日期範圍內各項要求指標的總計。

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

每日收益和廣告成效指標

針對已聲明版權的內容，這項要求會擷取其每日收益和廣告成效指標。

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

特定國家/地區的收益和廣告成效指標

這項要求會針對內容擁有者已聲明版權的內容，擷取特定國家/地區的收益和廣告成效指標。這些結果是按收益金額遞減排序，也就是說，合作夥伴在預估收益最高的國家/地區就是收益最高的國家/地區。

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

不同廣告類型的廣告成效指標

這項要求會針對內容擁有者已聲明版權的內容，擷取廣告成效指標。結果會按廣告類型分類，方便您比較不同廣告類型的收益和千次曝光出價。

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