API 要求範例

影片報表

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

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

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

影片報表

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

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

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