本文件將說明 YouTube Analytics API 和 YouTube Reporting API 存取 YouTube 數據分析資料的方式,存在差異和差異。這份文件旨在協助您為應用程式選擇合適的 API。
開發人員可以透過這兩種 API 擷取 YouTube 數據分析資料。此外,這兩個 API 都支援 YouTube 頻道擁有者和 YouTube 內容擁有者,每種 API 都可以存取一組特定的報表:
-
管道報表包含指定管道的使用者活動指標。
-
「內容擁有者」報表會針對所有與指定 YouTube 內容擁有者相連結的頻道匯總指標。例如,唱片公司可能會擷取一份報表,內含唱片公司所有演出者 YouTube 頻道的合併統計資料。部分內容擁有者報表包含使用者活動指標,有些則包含收益和廣告成效相關指標。
一些內容擁有者也能透過 Reporting API 存取系統管理的廣告收益報表。系統管理報表中的資料只能透過 Reporting API 擷取。
所有 YouTube Analytics (分析) 和 YouTube Reporting API 要求都必須獲得擁有必要資料的頻道或內容擁有者授權。
檢舉內容
API 擷取的報表包含兩種類型的資料:
-
維度是一種常見的資料匯總條件,例如使用者活動發生的日期,或是使用者所在的國家/地區。
在報表中,每一列都有不重複的維度值組合。因此,每一列的維度值組合會成為該列的主鍵。
-
指標則是評估使用者活動、廣告成效或預估收益的個別指標。使用者活動指標包括影片觀看次數和評分 (喜歡與不喜歡的人數) 等。
為您的應用程式選擇合適的 API
- YouTube Analytics API
- YouTube Analytics API 支援即時指定查詢,用於產生自訂 YouTube 數據分析報表。API 提供篩選和排序參數,因此呼叫應用程式不需要原生支援這些函式。
每個 API 要求都會指定資料傳回的日期範圍。這個 API 也能讓您擷取每週和每月的資料集。因此,呼叫應用程式不需要儲存擷取的資料集或不同日期範圍內的匯總統計資料。 - YouTube Reporting API
- YouTube Reporting API 擷取大量報表,內含頻道或內容擁有者的 YouTube 數據分析資料。適用於可匯入大型資料集的應用程式,以及提供篩選、排序及挖掘資料的工具。
每份報表都包含一組預先定義的欄位。開發人員利用這個 API 安排報表工作時間,每個工作都可用來找出 YouTube 應該產生的報表。接著,YouTube 會產生可非同步下載的每日報表。每份報表都包含特定 24 小時期間的資料。
此外,YouTube 會自動為擁有在 YouTube 創作者工作室中存取相應報表的內容擁有者管理一組系統報表。這些報表可透過程式存取廣告收益資料。 - 與字幕相關的使用者活動
- 播放清單的觀眾續看率資料
- 內容擁有者的收益報表 (有 2 份不同的報表)
- 適用於內容擁有者的資產報表 (有 11 種不同的報告)
受支援的報表
下表說明可透過 API 擷取的不同報表類型。您可以透過 YouTube Analytics API 存取指定的查詢,也可透過 YouTube Reporting API 取得大量報表。
您可能無法利用其中一個 API 取得資料。舉例來說,YouTube Analytics API 可讓您每週或每月擷取使用者活動指標,但 YouTube Reporting API 會要求您自行匯總資料。另一方面,YouTube Reporting API 也支援內容擁有者的資產報表,但 YouTube Analytics API 並不會提供這些資料。
報表類型 | |
---|---|
影片報表 | 支援頻道 (查詢或大量) 和內容擁有者 (查詢或大量)。 「影片」報告會針對頻道或內容擁有者的影片,提供所有使用者相關活動的統計資料。舉例來說,這些報表包含您的影片獲得的觀看次數。在 YouTube Analytics API 中,部分內容擁有者的影片報表也會提供預估收益和廣告成效成效指標。 |
播放清單報表 | 支援頻道 (查詢或大量) 和內容擁有者 (查詢或大量)。 「播放清單」報表提供與播放清單相關的影片觀看次數相關的統計資料。YouTube Reporting API 支援播放清單的觀眾續看率報表,但 YouTube Analytics API 不支援類似的報表。 |
廣告成效報表 | 適用於內容擁有者 (查詢或大量) 廣告成效報表會針對影片播放期間放送的廣告,提供曝光次數指標。這些指標會計入每次廣告曝光,且每次影片播放都會帶來多次曝光。 |
估算的收益報表 | 適用於內容擁有者 (大量)。 透過收益報表,您可以得知 Google 銷售的廣告來源和非廣告來源的影片帶來的總收益。這類報表也包含一些廣告成效成效指標。請注意,系統管理報表包含實際收益資料。 |
資產報表 | 適用於內容擁有者 (大量)。 資產報表可提供與內容擁有者資產連結影片相關的使用者活動指標。內容擁有者在 YouTube 的內容擁有者報表中,發現某部影片符合某項內容擁有者的某項資產。影片可能是由內容擁有者或其他 YouTube 使用者所上傳。 |
系統管理報表 | 在 YouTube 創作者工作室的「報表」專區中,有權存取相關報表的內容擁有者。 系統管理報表提供資產和影片實際收益資料。另一份報表會列出已聲明版權影片,以及與這些影片相符的資產。請注意,並非所有的創作者工作室報表都可在 API 使用。 注意:YouTube 會自動為擁有相應存取權的內容擁有者產生系統管理的報表,因此,擷取這些報表的程序與此名單中其他類型的報表不同。詳情請參閱系統管理報表的說明文件。 |
主要差異
下表列出了 YouTube 數據分析和 Reporting API 之間的重要差異。
功能 | YouTube Analytics API | YouTube Reporting API |
---|---|---|
擷取資料的處理程序 | 每個 API 要求都會指定要傳回的維度和指標,以及資料傳回的時間範圍。 | 應用程式會安排報表工作的時間。YouTube 會針對每項工作產生可非同步下載的每日報表。 |
日期範圍 | 部分 API 報表會指定使用者活動發生的日期。其中部分報表支援按月匯總使用者活動指標的維度。 | 所有 API 報表都會指定使用者活動發生的日期。使用 API 的應用程式可實作定期匯總資料的功能。 |
篩選資料 | 您可以篩選報表,只納入維度具有特定值的列。這個 API 也支援某些僅做為篩選器的維度,例如「洲別」和「子洲」。 | 這個 API 支援大量下載完整的資料集。但不支援篩選或篩選僅限篩選維度的資料。用戶端應用程式會儲存已下載的資料,並實作自己的功能來篩選資料。 |
排序 | 報表可以根據傳回的指標值排序。部分報表僅支援部分結果。舉例來說,報表列出頻道觀看次數最多的影片,最多會傳回 200 列。 | 這個 API 支援大量下載完整的資料集。用戶端應用程式可以實作自己的功能,對下載的資料進行排序。 |
列舉 | API 報表含有文字值 (例如「ANDROID」或「CHANNEL」),用於識別列舉的維度值。 | API 報表含有可對應至文字值的整數。 |
配額 | API 伺服器會評估每項查詢,以判斷配額費用。配額用量文件詳細說明瞭此方法。 | 配額用量不是問題,因為系統只擷取一次資料,然後在應用程式中加以篩選、排序及查詢。 |
不重複報表 |
|
|
不重複的維度 | group (僅限篩選器維度) 洲別 (僅限篩選器的維度) SubContinent (僅限篩選器維度) is isCurated==1 (僅限篩選器維度) viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
不重複指標 | 不重複 relativetainPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_前請思考點擊次數 |
API 命名差異
這兩個 API 目前使用不同的命名慣例來識別維度和指標。目前 YouTube 數據分析的 API 名稱採用 camelCase,YouTube Reporting API 名稱則會使用以底線分隔的名稱。
下表說明這兩個 API 用來辨識相同指標和維度的不同名稱。在某些情況下,這兩個名稱之間的差距大於將名稱從駝峰式大小寫轉換為底線後產生的結果。例如,YouTube 數據分析 API 中的 video
維度在 YouTube Reporting API 中會命名為 video_id
。