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) 為頻道內容獲得最多觀看次數的美國城市。結果會按照觀看次數遞減排序。

    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

影片報表

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

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

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