YouTube Analytics API 可產生含有 YouTube 數據分析資料的自訂報表。這個 API 支援頻道和內容擁有者的報表。報表欄位分為維度和指標：
「維度」是用來匯總資料的常見條件，例如動作發生的日期或使用者所在的國家/地區。
在報表中，每列資料都有不重複的維度值組合。因此，您為報表選擇的維度會決定 YouTube 如何計算該報表中的指標值。
指標是與使用者活動、廣告成效或預估收益相關的個別評估值。使用者活動指標包括影片觀看次數和評分 (喜歡和不喜歡)。
Analytics API 提供篩選和排序參數，因此呼叫應用程式不需要原生支援這些函式。您也可以透過 API 擷取 YouTube 數據分析群組的資料，群組是自訂集合，最多可加入 500 部影片、播放清單、頻道或資產。
選擇報表參數
使用 API 的 reports.query 方法要求報表時，API 要求會包含五個參數，用來決定報表值的計算方式：
startDate和endDate參數會指定報表資料的時間範圍。API 回應實際上包含截至指定最後一天的資料，且查詢時「查詢中」的所有指標都可用。metrics參數會指定要納入報表的評估項目。在頻道報表中，指標會評估使用者活動，並包含觀看次數和喜歡次數等值。部分指標也會評估廣告成效或預估收益。dimensions參數會說明指標的分組方式。filters參數說明報表資料的篩選方式。舉例來說，報表可以篩選出特定國家/地區、影片或影片群組的指標，而不是傳回頻道的所有資料。注意：API 可讓您為 video、playlist 和 channel 篩選器指定多個值。如果這麼做，您也可以在維度清單中加入該篩選器，這樣傳回的指標也會依影片、播放清單或頻道分組。
範例報表選項
舉例來說，假設頻道擁有者想擷取影片裝置類型報表，判斷頻道影片在行動裝置、遊戲主機、電視等裝置上的觀看次數。
頻道擁有者將
startDate參數設為2015-06-01，並將endDate參數設為2015-07-31。根據這些值，報表會包含兩個月的資料。裝置類型報表支援 views 和 estimatedMinutesWatched 指標，因此頻道擁有者將
metrics參數設為views,estimatedMinutesWatched。dimensions參數有多個選項可供頻道擁有者選擇。以下清單列出其中兩個，第三個則會在稍後的filters參數值說明中討論。如果將參數值設為
deviceType，系統會依裝置類型，將報表涵蓋期間的觀看次數和觀看時間分組。因此，報表資料會根據這個值回答下列問題：在 2015 年 6 月 1 日至 2015 年 7 月 31 日期間，頻道的影片在行動裝置上觀看了幾次？
2015 年 6 月 1 日至 2015 年 7 月 31 日期間，頻道影片在遊戲主機上的觀看次數為何？
報表會實際包含每種裝置類型的總觀看次數和觀看時間。
如果將參數值設為
day,deviceType，系統會根據報表統計期內每天的裝置類型，計算觀看次數和觀看時間。因此，有了這個值，報表資料就能回答以下問題：2015 年 6 月 1 日，頻道的影片在行動裝置上觀看了幾次？
2015 年 7 月 14 日，該頻道的影片在電視上的觀看次數是多少？
最後，
filters參數可讓頻道擁有者限制報表，只納入符合特定篩選器值的資料。這份報表支援的篩選選項太多，無法一一說明，因此這些範例僅代表您可以產生的報表的一小部分。頻道擁有者可以篩選要求，只傳回 Android 作業系統的值。(報表統計期內，Android 行動裝置上的觀看次數有多少？)
頻道擁有者可以篩選要求，只傳回特定國家/地區的值。(在報表統計期內，加拿大每天的影片觀看次數為何？)
頻道擁有者可以篩選要求，只傳回特定影片的值。不過，video 篩選器支援以逗號分隔的清單，因此報表實際上可能包含多部影片的資料。
此外，如果影片篩選器指定多個值，則影片也可以指定為維度。也就是說，
dimensions參數也支援deviceType,video和day,deviceType,video值。
資料更新間隔和延遲時間
雖然 YouTube Analytics API 支援指定查詢，但基礎數據分析資料並非即時。資料處理通常會產生 48 到 72 小時的延遲時間。因此，API 回應不含最近幾天的資料，且報表的 endDate 只會納入截至最後一天的資料，且所有要求的指標都已完整處理。
由於資料延遲，您可能會發現 API 傳回的資料與 YouTube 工作室中顯示的即時指標有差異。如果應用程式需要個別影片的即時統計資料，例如目前的觀看次數、喜歡次數或留言數，請使用 YouTube Data API 的 videos.list 方法，而非 YouTube Analytics API。
正在擷取報表
如要擷取報表，請傳送已授權的 GET 要求至 API 的 reports.query 方法，並指定定義要擷取報表的參數。
如需 API 支援的報表清單，請參閱頻道報表和內容擁有者報表說明文件。每份報表定義都會指出報表允許的 metrics、dimensions 和 filters 參數值。
最佳做法
使用 YouTube Analytics API 的應用程式應「一律」遵循下列做法：
- 使用回應的標題列，決定報表資料欄的排序。舉例來說，請勿假設「觀看次數」會是回應中傳回的第一個指標，只因為它是報表說明中列出的第一個指標。請改用回應的標頭列，判斷哪一欄包含該資料。
- 使用 YouTube Data API，擷取 YouTube Analytics API 回應中識別資源的其他中繼資料。根據《YouTube API 服務開發人員政策》(第 III.E.4.b 至 III.E.4.d 節)，API 用戶端必須在 30 天後刪除或重新整理該 API 儲存的資源中繼資料。
匯總指標和已刪除的項目
YouTube Analytics API 回應不含已刪除項目的指標細目。舉例來說，如果頻道擁有者刪除影片，該影片就不會再列於 API 回應中，而 API 回應會傳回每部影片的指標。不過，匯總一組資源指標的報表仍會包含與已刪除項目相關聯的指標。
舉例來說，假設頻道擁有者擷取兩份報表。第一份報表列出頻道所有影片在特定時間範圍內的每日總觀看次數。第二份報表則列出同一時間範圍內每部影片的每日總觀看次數。
在這種情況下，第一份報表中的數字會包含後來刪除的影片觀看次數，因為第一份報表包含每日匯總資料。不過，第二份報表不會包含與已刪除項目相關的觀看次數，因為第二份報表會逐一列出每部影片的觀看次數。因此，如果頻道在報表涵蓋的時間範圍內刪除影片，第一份報表中的每日觀看次數總計，可能會高於第二份報表中每日影片觀看次數的總和。
資料去識別化
如果指標未達特定門檻，部分 YouTube 數據分析資料會受到限制。這可能發生在各種報表中。實務上，這表示報表可能不會包含所有 (或任何) 資料，如果：
影片或頻道在特定時間範圍內的流量不足
或
您選取的篩選條件或維度 (例如流量來源或國家/地區) 未達到特定門檻。
此時，不同報表可能會出現不同的總計資訊，實際差異取決於報表匯總資料的方式。
舉例來說，假設頻道擁有者擷取兩份報表。第一份報表列出特定影片的總觀看次數，第二份報表則按國家/地區列出該影片的總觀看次數。該報表顯示在指定時間範圍內，影片獲得 1,000 次觀看，其中 500 次來自美國、498 次來自加拿大，2 次來自法國。
在本例中，第一份報表會顯示影片有 1, 000 次觀看，第二份報表則只會顯示影片在美國和加拿大分別獲得 500 次和 498 次觀看。因此，兩份報表的總觀看次數會出現落差。請注意，第二份報表不會顯示另外兩次觀看 (或法國的任何觀看)。
資料類型有限
YouTube 數據分析報表中的下列資料可能會受到限制：
- 受眾特徵資料，例如年齡和性別。
- 地理資料，包括與觀眾所在國家/地區相關的指標或維度，例如國家/地區。不過請注意，報表不會對收益指標套用地理位置門檻。
- 與特定流量來源相關的指標，例如引導觀眾觀看影片的搜尋字詞或外部網址。舉例來說，如果搜尋字詞和網址帶來的觀看次數極少，就不會顯示在報表中，但你仍會看到為內容帶來大量觀眾的字詞和網址。
如要進一步瞭解 YouTube 數據分析報表中的限制資料，請造訪 YouTube 說明中心。
配額用量
您提出的每項 API 要求都會計為一個單位的 API 用量配額。配額限制會顯示在 Google Cloud 控制台的「Quotas」(配額) 面板中。