本頁面顯示 YouTube Analytics API 要求範例。每個範例簡單說明要擷取的報表,並顯示對應的 dimensions
、metrics
、filters
和 sort
參數值。(頻道報表和內容擁有者報表可指出 API 支援的報表)。
每個範例都會連結至 Google APIs Explorer,並以顯示的值填入。範例也會使用 2023-09-01
和 2024-03-31
的預設開始和結束日期 (YYYY-MM-DD
)。
連結至 API 檢視工具後,您仍然必須指定要擷取報表的管道或內容擁有者。視您按下的查詢而定,API Explorer 會將 channel==MINE
或 contentOwner==CONTENT_OWNER_ID
填入 ids
參數值。如果是管道報表,您可以將 MINE
變更為已驗證使用者的頻道 ID。建立內容擁有者報告時,您必須將 CONTENT_OWNER_ID
替換成您的內容擁有者 ID。
此外,您必須以指定頻道或內容擁有者的身分進行驗證,才能讓 API Explorer 使用 OAuth 2.0 為您的 API 要求提供授權。
按多個維度/指標排序要求
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
替換成已驗證使用者頻道中播放清單的播放清單 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) 為頻道內容獲得最多觀看次數的美國城市。結果會按照觀看次數遞減排序。
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 檢視工具中執行這項查詢,您必須將 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 搜尋結果中,產生最多觀看次數的 10 個搜尋字詞。結果會按照觀看次數遞減排序。請注意,如要在 API 檢視工具中執行這個查詢,您必須將 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 探索工具中執行查詢,您必須將 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 作業系統中的播放清單觀看次數每日裝置類型指標
這項查詢會擷取特定頻道播放清單的每日觀看次數 (匯總影片指標)、播放清單觀看次數 (播放清單內指標),以及 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
影片的觀眾續看率指標
這份報表會評估影片留住觀眾的能力。一次只能擷取單一影片的報表。請注意,如要在 API 檢視工具中執行這項查詢,您必須將 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 部影片。結果會按照觀看次數遞減排序。請注意,如要在 API Explorer 中執行查詢,您必須將 filters
參數值中的字串 CHANNEL_ID
替換成以半形逗號分隔的清單,最多列出 500 個各管道的管道 ID。
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 大熱門 - 頻道觀看次數最多影片的註解點閱率
這項要求會針對指定頻道或一組頻道中,觀看次數最多的 10 部影片,擷取觀看次數、註解點閱率、註解關閉率及註解曝光次數。結果會按照觀看次數遞減排序,因此觀看次數最多的影片會優先列出。請注意,如要在 API Explorer 中執行查詢,您必須將 filters
參數值中的字串 CHANNEL_ID
替換成以半形逗號分隔的清單,最多列出 500 個各管道的管道 ID。
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
播放清單報表
內容擁有者頻道的播放清單觀看次數
這項要求會擷取內容擁有者頻道上的播放清單總開始播放次數、播放清單估計觀看時間 (分鐘)、播放清單觀看次數,以及每個播放清單開始播放次數的次數。playlistViews
指標只會計算在播放清單中發生的影片觀看次數。所有要求的指標都是播放清單中的指標,因此要求並不需要加入播放清單或群組篩選器。
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
特定播放清單的統計資料
這項要求會擷取總播放清單開始播放次數、估計觀看時間 (分鐘)、觀看次數 (匯總影片指標)、播放清單觀看次數 (播放清單內指標),以及特定播放清單開始播放次數時所產生的觀看次數。請注意,如要在 API 探索工具中執行這項查詢,您必須將 filters
參數值的字串 PLAYLIST_ID
替換成其中一個內容擁有者頻道中某個播放清單的播放清單 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
影片報表
按內容類型顯示喜歡與不喜歡的人數
這項查詢會擷取特定頻道或頻道群組中各類內容的喜歡和不喜歡人數。請注意,如要在 API Explorer 中執行查詢,您必須將 filters
參數值中的字串 CHANNEL_ID
替換成以半形逗號分隔的清單,最多列出 500 個各管道的管道 ID。
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
影片報表
來自不同播放位置的觀看次數和觀看時間
這項查詢會擷取上傳至特定頻道或頻道群組的影片觀看次數和預估觀看時間。系統會根據影片播放發生的網頁或應用程式類型來匯總結果,並依照觀看次數遞減排序。請注意,如要在 API Explorer 中執行查詢,您必須將 filters
參數值中的字串 CHANNEL_ID
替換成以半形逗號分隔的清單,最多列出 500 個各管道的管道 ID。
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
每日觀看次數和來自不同播放位置的觀看時間
這項查詢會擷取上傳至特定頻道或一組頻道的影片每日觀看次數和預估觀看時間。系統會按照播放影片播放次數的各類型網頁或應用程式,按每日分類結果。結果會依時間順序由新至舊排序。請注意,如要在 API Explorer 中執行查詢,您必須將 filters
參數值中的字串 CHANNEL_ID
替換成以半形逗號分隔的清單,最多列出 500 個各管道的管道 ID。
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
前 10 大 - 為內嵌影片獲得最多觀看次數的第三方網站
這項查詢會擷取特定影片或一組影片的觀看次數和預估觀看時間。並依嵌入影片的第三方網站來分組。結果會依觀看次數遞減排序。請注意,如要在 API 探索工具中執行查詢,您必須將 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 探索工具中執行查詢,您必須將 filters
參數值中的字串 VIDEO_ID
替換成以半形逗號分隔的清單,最多列出 500 個已上傳影片 ID。
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
前 10 大 - 為影片帶來最多流量的外部網站
此查詢會從 Google 搜尋結果中,擷取為特定影片或一組影片帶來最多觀看次數的外部網站。結果是依預估觀看時間遞減排序。請注意,如要在 API 探索工具中執行查詢,您必須將 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
不同流量來源的播放清單觀看次數和觀看時間
這項要求會擷取一或多個內容擁有者頻道的播放清單觀看次數、播放清單開始次數,以及播放清單的預估觀看時間。這些指標是按照流量來源匯總。請注意,如要在 API Explorer 中執行查詢,您必須將 filters
參數值中的字串 CHANNEL_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 作業系統中的播放清單觀看次數裝置類型指標
這項查詢會擷取一或多個內容擁有者頻道上的播放清單在 Android 裝置上的播放清單觀看次數和預估觀看時間。系統會針對發生播放清單觀看次數的各類裝置傳回結果。請注意,如要在 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 檢視工具中執行這項查詢,您必須將 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