API 要求範例

本頁面顯示 YouTube Analytics API 要求的實例。每個範例會簡單說明要擷取的報表,然後顯示對應的 dimensionsmetricsfilterssort 參數值。(頻道報表內容擁有者報表文件說明瞭 API 支援的報表)。

每個範例都會連結至 Google API Explorer,並填入顯示的值。這些範例也會使用預設的 2022-01-012022-06-30 開始與結束日期 (YYYY-MM-DD)。

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

您也必須以指定的頻道或內容擁有者身分進行驗證,這樣 API 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

播放清單報表

頻道播放清單的總觀看次數

此要求會擷取已驗證使用者頻道中播放清單的播放清單,從播放清單開始觀看、預估觀看時間、觀看次數,以及每個播放清單的觀看次數。views 指標只會計算播放清單內發生的影片觀看次數。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

特定播放清單的統計資料

此要求會擷取特定播放清單的開始播放次數、預估觀看時間 (分鐘)、觀看次數和每個播放清單的觀看次數。views 指標只會計算播放清單內發生的影片觀看次數。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 PLAYLIST_ID 字串替換成已驗證使用者頻道中播放清單的播放清單 ID。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

如要擷取多個播放清單的匯總統計資料,您也可以在已驗證使用者的頻道中,將播放清單 PLAYLIST_ID 替換成以逗號分隔的清單,其中列出播放清單中最多包含 500 個播放清單的 ID。

10 大熱門:頻道最常觀看的播放清單

這項查詢會擷取頻道在指定的日期範圍內 (最多 10 個) 觀看率最高的播放清單。這項工具也會擷取其他幾項播放清單指標,例如觀眾開始播放每個播放清單的次數,以及觀眾開始播放影片後的平均觀看時間。搜尋結果會依據預估時間 (以遞減順序) 排序。

注意:由於這份報表使用 playlist 維度,因此您需要為 sort 請求參數指定值,並將 maxResults 參數設為 10 以下的整數。

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
根據時間

影片報表

頻道影片的每日觀看時間指標

這項查詢會擷取頻道影片的每日觀看次數、觀看時間指標和新訂閱人數。此報告會傳回指定日期範圍內每一天的資料。資料列會按時間順序排序。

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

頻道影片的每日註解指標

這個要求會擷取頻道內容的每日觀看次數、註解點閱率、註解關閉率和註解曝光次數。結果會依時間先後順序排序。

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

播放清單報表

頻道的每日播放清單觀看次數

這個要求會從已驗證的使用者頻道擷取每日觀看次數、播放清單開始播放次數、預估觀看時間,以及每個播放清單的觀看次數。結果會依時間先後順序排序。

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
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
filters=isCurated==1
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 中,將 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
filters=isCurated==1
sort=-playlistStarts

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

這項查詢會擷取特定頻道播放清單的美國每日播放清單開始播放次數、觀看次數和預估觀看時間。依照發生觀看次數的播放清單,來分類各類型的網頁或應用程式。結果會依時間先後順序排序。

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
流量來源

影片報表

特定國家/地區不同流量來源的觀看次數和觀看時間

這項要求會擷取頻道在特定國家/地區的觀看次數和預估觀看時間。這些指標會按流量來源匯總,說明使用者到達影片的方式。

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

來自不同流量來源的每日觀看次數和觀看時間

這項要求會擷取頻道影片的每日觀看次數和每日預估觀看時間。這些指標每天都會按流量來源彙整,並按時間順序排序。

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

前 10 名 - 為影片帶來最多流量的 YouTube 搜尋字詞

這項查詢會擷取 10 個搜尋字詞,其中 10 個搜尋字詞在 YouTube 搜尋結果中為一或多部影片帶來最多觀看次數。結果會依觀看次數以遞減方式排序。請注意,如要在 APIs 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 個外部網站。並按照預估觀看時間遞減排序。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的字串 VIDEO_ID 改成以逗號分隔的清單,其中列出最多 500 個影片 ID 的影片 ID。

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

播放清單報表

某國家/地區不同流量來源的播放清單觀看次數和觀看時間

這項要求會擷取特定國家/地區的播放清單觀看次數、播放清單開始播放次數,以及播放清單觀看次數的預估觀看時間。這些指標會依流量來源彙整,說明使用者到達播放清單的方式。

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

來自不同流量來源的每日播放清單觀看次數和觀看時間

這項要求會擷取頻道的每日播放清單觀看次數、播放清單開始播放次數,以及播放清單觀看次數的預估觀看時間。這些指標每天都會按流量來源彙整,並按時間順序排序。

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1
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
filters=isCurated==1;operatingSystem==ANDROID
sort=day

行動裝置播放清單觀看次數的每日作業系統指標

這項查詢會擷取特定頻道播放清單的行動裝置每日播放清單觀看次數和預估觀看時間。結果會依據發生播放清單播放次數的各個作業系統按日分組。結果會依時間先後順序排序。

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
客層

影片報表

加州觀眾的年齡層 (年齡層和性別)

這份報表會擷取加州觀眾的年齡層和性別統計資料,結果會依性別排序,接著是依年齡層排序。您可以修改這個查詢,透過調整 filters 參數值來擷取全球所有觀眾,或是某國家/地區、洲別、子洲別或其他美國州別的所有觀眾。

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

播放清單報表

加州的播放清單觀眾客層 (年齡層和性別)

這份報表會擷取加州觀眾的年齡層和性別統計資料,結果會依性別排序,接著是依年齡層排序。您可以修改這個查詢,透過調整 filters 參數值來擷取全球所有觀眾,或是某國家/地區、洲別、子洲別或其他美國州別的所有觀眾。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
社交

分享指標 (依影片分享影片匯總)

這個要求會擷取使用者使用 Share 按鈕分享頻道影片的次數。結果會依共用服務 (Google+、Twitter 等) 匯總,並依股數遞減排序。

dimensions=sharingService
metrics=shares
sort=-shares
觀眾續看率

影片的觀眾續看率指標

這份報表會評估影片是否能持續吸引觀眾的注意力。系統一次只能擷取單一影片的報告。請注意,如要在 APIs 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 部影片,並擷取其收益和廣告成效成效指標。結果會依收益金額遞減排序,這表示第一部影片將是預估收益最高的影片。

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 字串替換成以逗號分隔的清單,當中包含您的頻道 ID (最多 500 個)。

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

前 10 名 - 頻道觀看次數最多的影片註解點閱率

這項要求會擷取特定頻道或頻道中觀看次數最多的 10 部影片,並擷取觀看次數、註解點閱率、註解關閉率和註解曝光次數。結果會依觀看次數以遞減方式排序,也就是觀看次數最多的影片會優先列出。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以逗號分隔的清單,當中包含您的頻道 ID (最多 500 個)。

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

播放清單報表

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

此要求會擷取內容擁有者頻道中播放清單,從播放清單開始觀看、預估觀看時間 (分鐘)、觀看次數及每個播放清單的觀看次數。views 指標只會計算播放清單內發生的影片觀看次數。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

特定頻道的播放清單觀看次數

此要求會擷取內容擁有者頻道中播放清單,從播放清單開始觀看、預估觀看時間 (分鐘)、觀看次數及每個播放清單的觀看次數。views 指標只會計算播放清單內發生的影片觀看次數。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以逗號分隔的清單,當中包含您的頻道 ID (最多 500 個)。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;channel==CHANNEL_ID

播放清單的統計資料

此要求會擷取特定播放清單的開始播放次數、預估觀看時間 (分鐘)、觀看次數和每個播放清單的觀看次數。views 指標只會計算播放清單內發生的影片觀看次數。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 PLAYLIST_ID 字串替換成內容擁有者頻道中播放清單的播放清單 ID。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

如要擷取多個播放清單的匯總統計資料,您也可以將 PLAYLIST_ID 字串替換為以逗號分隔的清單,其中列出內容擁有者頻道中播放清單的最多 500 個播放清單 ID。

前 10 名:觀看次數最多的內容擁有者播放清單

這項查詢會擷取內容擁有者在某個日期範圍內最多觀看的 10 名播放清單,計算依據為指定日期範圍內的預估觀看時間 (以分鐘為單位)。這項工具也會擷取其他幾項播放清單指標,例如觀眾開始播放每個播放清單的次數,以及觀眾開始播放影片後的平均觀看時間。搜尋結果會依據預估時間 (以遞減順序) 排序。

注意:由於這份報表使用 playlist 維度,因此您需要為 sort 請求參數指定值,並將 maxResults 參數設為 10 以下的整數。

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
根據時間

影片報表

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

這項查詢會擷取內容擁有者每日上傳的影片觀看時間,以及觀看次數、營利播放次數和曝光次數。此報表會按指定日期範圍內的每列傳回一列資料,然後依照時間順序排序。

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

播放清單報表

內容擁有者的每日播放清單觀看次數

這項要求會擷取內容擁有者頻道中所有播放清單的每日觀看次數、播放清單開始播放次數、預估觀看時間,以及每個播放清單的觀看次數。結果會依時間先後順序排序。

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
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=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

前 10 名 – 美國最受歡迎的播放清單

這項查詢會從指定內容擁有者的 10 個播放清單中擷取出指定日期範圍內指定美國觀眾最常觀看的播放清單。結果會依據播放清單數量以遞減順序排序。

注意:由於這份報表使用 playlist 維度,因此您需要為 sort 請求參數指定值,並將 maxResults 參數設為 10 以下的整數。

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
播放詳細資料

影片報表

按內容類型劃分的喜歡與不喜歡次數

這項查詢會擷取特定頻道或頻道群組中各內容類型的喜歡和不喜歡次數。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以逗號分隔的清單,當中包含您的頻道 ID (最多 500 個)。

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID
播放位置

影片報表

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

這項查詢會擷取特定頻道或頻道群組上傳影片的觀看次數和預估觀看時間。結果是按照發生影片播放的網頁或應用程式類型彙整,並依照觀看次數排序。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以逗號分隔的清單,當中包含您的頻道 ID (最多 500 個)。

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

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

這項查詢會擷取在美國上傳至特定頻道或頻道群組的影片觀看次數和預估的觀看時間。依照發生影片播放類型的網頁或應用程式,按日將結果分組。結果是按照時間先後順序排序。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以逗號分隔的清單,當中包含您的頻道 ID (最多 500 個)。

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

前 10 名 - 嵌入影片觀看次數最高的第三方網站

這項查詢會擷取特定影片或一組影片的觀看次數和預估觀看時間。結果會依照嵌入影片的第三方網站進行分組。結果會依觀看次數以遞減方式排序。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的字串 VIDEO_ID 改成以逗號分隔的清單,其中列出最多 500 個影片 ID 的影片 ID。

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

播放清單報表

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

這項查詢會擷取內容擁有者頻道中所有播放清單的觀看次數、預估觀看時間和播放清單開始播放次數。系統會依照發生影片播放的網頁或應用程式類型來彙整結果,並依照播放清單開頭到後的順序排序。

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

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

這項查詢會擷取內容擁有者頻道中所有播放清單的每日觀看次數、觀看次數和預估觀看時間。依照發生觀看次數的播放清單,來分類各類型的網頁或應用程式。結果會依時間先後順序排序。

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
流量來源

影片報表

來自不同流量來源的觀看次數和觀看時間

這項要求會擷取內容擁有者影片的觀看次數和預估觀看時間。這些指標會按流量來源匯總,說明使用者到達影片的方式。

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 個搜尋字詞。結果會依觀看次數以遞減方式排序。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的字串 VIDEO_ID 改成以逗號分隔的清單,其中列出最多 500 個影片 ID 的影片 ID。

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

前 10 名:可為影片帶來最多流量的外部網站

這項查詢會擷取 10 個外部網站,其中 10 個透過某個或某組影片在 Google 搜尋結果中產生最多觀看次數。並按照預估觀看時間遞減排序。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的字串 VIDEO_ID 改成以逗號分隔的清單,其中列出最多 500 個影片 ID 的影片 ID。

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

播放清單報表

某國家/地區不同流量來源的播放清單觀看次數和觀看時間

這項要求會擷取特定國家/地區的播放清單觀看次數、播放清單開始播放次數,以及播放清單觀看次數的預估觀看時間。這些指標會依流量來源彙整,說明使用者到達播放清單的方式。

dimensions=insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

來自不同流量來源的每日播放清單觀看次數和觀看時間

這項要求會擷取一或多個內容擁有者頻道中播放清單的每日觀看次數、播放清單開始播放次數和預估觀看時間。這些指標每天都會按流量來源彙整,並按時間順序排序。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以逗號分隔的清單,當中包含您的頻道 ID (最多 500 個)。

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID
sort=day
裝置/作業系統

影片報表

已聲明版權影片的每日裝置類型指標

這項查詢會擷取特定內容擁有者聲明版權的影片,並依裝置類型擷取每日觀看次數和預估觀看時間。按發生播放資料的裝置類型,依日期將結果分組。結果會依時間先後順序排序。

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 裝置上,來自一或多名內容擁有者頻道中播放清單的每日觀看次數和預估觀看時間。按「播放清單檢視次數」區分的裝置類型,按日分組。結果會依時間先後順序排序。請注意,如要在 APIs Explorer 中執行這項查詢,您必須將 filters 參數值中的 CHANNEL_ID 字串替換成以逗號分隔的清單,當中包含您的頻道 ID (最多 500 個)。

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID
sort=day

行動裝置播放清單觀看次數的每日作業系統指標

這項查詢會擷取內容擁有者所有頻道中播放清單的每日觀看次數和預估觀看時間。結果會依據發生播放清單播放次數的各個作業系統按日分組。結果會依時間先後順序排序。

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
客層

影片報表

加州觀眾的年齡層 (年齡層和性別)

這份報告會擷取加州觀眾年齡層資訊,以及查看已聲明版權內容擁有者之內容的收視性別。結果會依性別排序,接著是依年齡層排序。您可以修改這個查詢,透過調整 filters 參數值來擷取全球所有觀眾,或是某國家/地區、洲別、子洲別或其他美國州別的所有觀眾。

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

播放清單報表

加州的播放清單觀眾客層 (年齡層和性別)

這份報表會擷取加州觀眾年齡層資訊,並觀看過該內容擁有者頻道的所有播放清單。結果會依性別排序,接著是依年齡層排序。您可以修改這個查詢,透過調整 filters 參數值來擷取全球所有觀眾,或是某國家/地區、洲別、子洲別或其他美國州別的所有觀眾。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;province==US-CA
sort=gender,ageGroup
觀眾續看率

影片的觀眾續看率指標

這份報表會評估影片是否能持續吸引觀眾的注意力。系統一次只能擷取單一影片的報告。請注意,如要在 APIs 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 部影片的收益和廣告成效指標,其中內容擁有者已聲明版權且收益最高的影片。結果會依收益金額遞減排序,這表示第一部影片將是預估收益最高的影片。

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