修訂記錄

本頁面列出 YouTube Reporting API 和 YouTube Analytics API 的 API 異動和說明文件更新。這兩種 API 都能讓開發人員存取 YouTube 數據分析資料，但存取方式不盡相同。訂閱這個變更記錄。訂閱敬上

2024 年 5 月 6 日

YouTube Analytics (目標查詢) API 支援三種新的頻道報表：

此外，目標對象 回訪率報表經過強化，以支援三種全新指標：

2024 年 4 月 7 日

YouTube 數據分析 (目標查詢) API 針對內容擁有者推出幾項更新 播放清單報表。更新內容與頻道播放清單報表的相關更新相同 這項產品是在 2024 年 1 月 19 日宣布的

下列修訂版本紀錄項目提供近乎 與 2024 年 1 月 19 日的內容相同。不過請注意 播放清單報表則可支援 isCurated 的尺寸至 2024 年 12 月 31 日，頻道播放清單報表會納入這項維度，直到 2024 年 6 月 30 日。

  • 注意：這是淘汰公告。

    isCurated 內容擁有者播放清單報表已淘汰維度。課程結束之後 2024 年 12 月 31 日當天或之後的支援。該維度的定義已更新 。

    為了在移除 isCurated 時保留回溯相容性 維度，您也必須更新程式碼來擷取 playlistViews 指標 而非「views」指標。自 views以來 指標仍適用於播放清單報表，儘管兩者的意義不同， 如未更新指標名稱，系統還是會傳回資料。當然，您可以修改應用程式 擷取並顯示 views 和 playlistViews。

    除了 isCurated 維度外，下列 API 功能還為 。

    • 以下功能不支援位置篩選器 (例如 continent 和 subcontinent) 新的頻道播放清單報表。
    • 「redViews」和「estimatedRedMinutesWatched」指標已不再適用 新的頻道播放清單報表。YouTube 工作室並未提供這些指標 因此這項變更可讓 API 功能與 Studio 應用程式提供的功能保持一致。
    • subscribedStatus 和 youtubeProduct 維度不再是 頻道播放清單報表篩選器這些篩選器之前無法在 YouTube 工作室，因此這項異動可讓 API 功能與 管理 Studio 應用程式

  • 播放清單報表 著作權擁有者檢舉說明文件的章節已更新，現在能針對 播放清單報表支援的指標類型如下：

    • 匯總影片指標 提供從 內容擁有者的播放清單；匯總影片指標如下： 僅支援未使用 isCurated 維度的 API 要求。
    • 播放清單內指標 在播放清單頁面上顯示使用者活動和參與度。這些指標 也會納入播放清單中非擁有影片的觀看次數 只有在這些觀看次數發生於播放清單情境時
    • 支援的播放清單指標 版面會識別匯總影片指標和播放清單內指標 。

  • 播放清單報表支援下列新的播放清單內指標 內容擁有者。請注意，只有在擷取 API 要求時，系統才會支援這些指標 報表「不會」使用 isCurated 維度。詳情請參閱 metrics 說明文件 每個指標的定義：

  • views 的行為 指標現在取決於擷取播放清單報表的 API 要求是否使用 isCurated 維度：

    • 要求包含 isCurated 維度時， views指標是播放清單內 」指標顯示影片在 內容擁有者的播放清單。
    • 如果要求不包含 isCurated 維度，則 views 指標是匯總影片指標，會指定影片總數 內容擁有者的播放清單中影片獲得的觀看次數 次觀看。匯總總數僅包含以下項目的觀看次數： 所有與擁有播放清單的頻道相關聯之內容擁有者擁有的影片。

      這些報表中沒有使用 isCurated 維度， playlistViews指標代表影片觀看次數 加入播放清單中的說明文字這個指標會計算播放清單中所有影片的觀看次數 無論資產所屬的管道為何

  • 每份播放清單報表 內容擁有者報告 說明文件已納入相關表格，列出該報表支援的指標 指出 API 要求是否包含 isCurated 維度。詳情請參閱 以時間為基礎的播放清單報表 例如，

2024 年 1 月 19 日

YouTube 數據分析 (目標查詢) API 針對頻道播放清單推出幾項更新 報表。本次更新包含已淘汰的維度，以及幾項全新和更新的指標：

  • 注意：這是淘汰公告。

    isCurated 為管道報表淘汰維度。已於 或 停止支援 2024 年 6 月 30 日後該維度的定義也已據此更新。

    為了在移除 isCurated 時保留回溯相容性 維度，您也必須更新程式碼來擷取 playlistViews 指標 而非「views」指標。自 views以來 指標仍適用於播放清單報表，儘管兩者的意義不同， 如未更新指標名稱，系統還是會傳回資料。當然，您可以修改應用程式 擷取並顯示 views 和 playlistViews。

    除了 isCurated 維度外，下列 API 功能還為 。

    • 以下功能不支援位置篩選器 (例如 continent 和 subcontinent) 新的頻道播放清單報表。
    • 「redViews」和「estimatedRedMinutesWatched」指標已不再適用 新的頻道播放清單報表。YouTube 工作室並未提供這些指標 因此這項變更可讓 API 功能與 Studio 應用程式提供的功能保持一致。
    • subscribedStatus 和 youtubeProduct 維度不再是 頻道播放清單報表篩選器這些篩選器之前無法在 YouTube 工作室，因此這項異動可讓 API 功能與 管理 Studio 應用程式

  • 播放清單報表 頻道檢舉說明文件的章節已更新，現在能更詳盡地說明 播放清單報表支援的指標類型如下：

    • 匯總影片指標 提供從 其他頻道的播放清單匯總影片指標如下： 僅支援未使用 isCurated 維度的 API 要求。
    • 播放清單內指標 在播放清單頁面上顯示使用者活動和參與度。這些指標 也會納入播放清單中非擁有影片的觀看次數 只有在這些觀看次數發生於播放清單情境時
    • 支援的播放清單指標 版面會識別匯總影片指標和播放清單內指標 。

  • 頻道的播放清單報表支援下列新的播放清單內指標。 內容擁有者報表尚未支援這些指標。請注意，這些指標 只有在可擷取報表的 API 請求「不要」使用 isCurated維度。詳情請參閱 metrics 說明文件 每個指標的定義：

  • views 的行為 指標現在取決於擷取播放清單報表的 API 要求是否使用 isCurated 維度：

    • 要求包含 isCurated 維度時， views指標是播放清單內 」指標顯示影片在 播放清單中
    • 如果要求不包含 isCurated 維度，則 views 指標是匯總影片指標，會指定影片總數 頻道播放清單中影片的觀看次數 次觀看。匯總總數僅包含以下項目的觀看次數： 播放清單下的影片。

      這些報表中沒有使用 isCurated 維度， playlistViews指標代表影片觀看次數 加入播放清單中的說明文字這個指標會計算播放清單中所有影片的觀看次數 無論資產所屬的管道為何

  • 每份播放清單報表的頻道報表 說明文件已納入相關表格，列出該報表支援的指標 指出 API 要求是否包含 isCurated 維度。詳情請參閱 以時間為基礎的播放清單報表 例如，

2023 年 12 月 4 日

YouTube 數據分析 (目標查詢) API 已更新，合併兩個 insightTrafficSourceType 維度值先前，這個維度是區分在播放清單中播放的影片 (PLAYLIST) 和來自列出播放清單中所有影片的網頁的觀看次數 (YT_PLAYLIST_PAGE)。往後，這兩種檢視畫面都會與 「PLAYLIST」維度值。

2022 年 12 月 15 日

YouTube Analytics (目標查詢) API 支援兩個新維度和一種新報表：

  • 新推出的報表會依城市顯示使用者活動。這份報表適用於 管道和 內容擁有者。 這份報表包含新的city 維度，能夠識別 YouTube 推測使用者活動所在城市的預估值。

  • 新的 creatorContentType 維度可識別與使用者活動相關的 YouTube 內容類型 。支援的值為 LIVE_STREAM、SHORTS、 STORY和VIDEO_ON_DEMAND。

    所有資料的選用維度皆可使用「creatorContentType」維度做為選用維度 頻道和內容擁有者的影片報表

  • YouTube Analytics API 請求範例指南現在提供這兩種新維度的範例。

  • 7DayTotals 和 30DayTotals 維度的參照之前已經是 會從說明文件中移除我們已於 10 月宣布淘汰這些維度 2019 年。

2022 年 8 月 26 日

YouTube Analytics (目標查詢) API 和 YouTube Reporting (大量報表) API 兩者 支援新的流量來源詳細資料值：

2022 年 2 月 11 日

我們將自 8 月或之後變更「gender」維度的有效值組合 2022 年 11 月。這可能會在您的 API 實作項目中造成回溯不相容的變更。為了遵循 向後 《YouTube API 服務條款》中針對不相容的變更部分， 。請更新 API 實作方式 ，以確保您可以使用一組新的值順利轉換。

具體的變更如下：

  • 在 YouTube 數據分析 (目標查詢) API 中， 目前有 gender 個維度 支援兩個值：female 和 male。自 2022 年 8 月 11 日起 維度支援三個值：female、male 和 user_specified。
  • 在 YouTube Reporting (大量報表) API 中， 目前有 gender 個維度 支援三個值：FEMALE、MALE 和 GENDER_OTHER。 2022 年 8 月 11 日當天或之後，支援的值組合將變更為 FEMALE、 MALE和USER_SPECIFIED。

2022 年 2 月 9 日

已更新兩項指標以排除 循環短片流量，截至 2021 年 12 月 13 日。這項異動會影響 YouTube 數據分析 (目標查詢) API 和 YouTube Reporting (大量報表) API。

2022 年 2 月 2 日

這個 YouTube Reporting (大量報表) API 支援新的流量來源維度值， 表示觀看次數源自於 直播重新導向：

以這個流量來源類型來說 traffic_source_detail 維度會指定參照觀眾的頻道 ID。

2020 年 9 月 23 日

你可以使用 YouTube Analytics (目標查詢) API 和 YouTube Reporting (大量報表) API 支援新的流量來源維度值，表示該觀眾是 在 YouTube Shorts 觀看體驗中垂直滑動：

流量來源詳細資料維度： insightTrafficSourceDetail 或 YouTube Analytics API 中 traffic_source_detail 的資料，系統不會針對這個新的流量來源類型填入資料。

2020 年 7 月 20 日

本次更新涵蓋了對 YouTube 數據分析 (目標查詢) API 的兩項異動：

2020 年 2 月 13 日

本次更新包含下列 YouTube 數據分析相關異動 (指定查詢) API 和 YouTube Reporting (大量報表) API。如要進一步瞭解這些變更，請前往 YouTube 說明中心。

在兩個 API 中，系統即將變更通知的流量來源詳細資料值。 在指定查詢中 通知會回報為 insightTrafficSourceType=NOTIFICATION。於 大量報表、 通知會回報為 traffic_source_type=17。

新值會分割與已上傳影片和直播相關的通知 (先前為 回報為 uploaded，分為兩個類別：

  • uploaded_push - 來自傳送推播通知的觀看次數 上傳影片時的訂閱人數
  • uploaded_other - 源自非推播通知的觀看次數，例如 電子郵件或收件匣通知。系統會在影片上傳時發送電子郵件通知訂閱者。

系統會針對 2020 年 1 月 13 日 (2020 年 1 月 13 日) 的時間範圍內傳回這些值。

另外提醒您，這些值並非通知本身，而是流量 帶來特定 YouTube 觀看次數的來源。舉例來說，如果報表列顯示「views=3」， traffic_source_type=17 (NOTIFICATION) 和 traffic_source_detail=uploaded_push，這一列表示有三個檢視畫面 是因觀眾點選推播通知而產生的結果。

2019 年 10 月 15 日

本次更新中包含下列 YouTube 數據分析 (目標查詢) API 的相關異動：

  • 注意：這是淘汰公告。

    YouTube 即將停止支援 7DayTotals 和 30DayTotals 維度。但您仍可使用這些維度擷取資料，直到 2020 年 4 月 15 日為止。自該日期當天或之後，如果您嘗試使用 7DayTotals 或 30DayTotals 維度擷取報表，就會傳回錯誤。

    請注意，使用者可以使用「day」維度查詢，並匯總或產生 7 天或 30 天期間的資料，以重現這些維度的部分資料。例如：

    • 將效期內每一天的觀看次數加總後，即可算出七天內的觀看次數。
    • 7 天的觀眾百分比計算方式是將每日觀看次數乘以該日觀看人數，得出於當天觀看影片時已登入的觀眾人數。接著，系統會將整個時段的已登入觀眾人數加總，除以該時段的總觀看次數，就能算出整個時段的觀眾百分比。
    • 系統無法計算 7 天內的不重複觀眾人數，因為同一位觀眾可能會被計算為不同日期的不重複觀眾。不過，或許您可以使用「month」維度來推斷 30 天內不重複觀眾人數的相關資料，像是「30DayTotals」維度。請注意，month 維度是指日曆月數，30DayTotals 維度是根據指定的開始和結束日期計算 30 天的期間。

2019 年 6 月 27 日

本次更新中包含下列 YouTube 數據分析 (目標查詢) API 的相關異動：

  • 自第 1 版 API 已完全淘汰，說明文件已經更新，移除參照該版本的參考資料，包括淘汰通知和遷移指南，說明如何更新至第 2 版。

2018 年 11 月 1 日

本次更新中包含下列 YouTube 數據分析 (目標查詢) API 的相關異動：

  • 第 1 版的 API 現已淘汰。如果您尚未更新 API 用戶端，請盡快改用 API 第 2 版，以免服務中斷。詳情請參閱遷移指南。

    請注意，我們原本是在 2018 年 4 月 26 日宣布淘汰原定的時間表。

2018 年 9 月 17 日

本次更新中包含下列 YouTube 數據分析 (目標查詢) API 的相關異動：

  • 有關資料模型總覽文件的新資料去識別化一節說明，當指標未達到特定門檻時，部分 YouTube 數據分析資料會受到限制。這可能在許多情況下都可能發生。實際上，這表示在下列情況下，報表可能不會包含所有 (或任何) 資料：

    1. 影片或頻道在特定時間範圍內的流量有限

      或

    2. 您選取了某個篩選器或維度 (例如流量來源或國家/地區)，這些篩選器的值未達到特定門檻。

    新章節也會討論 YouTube 數據分析報表中可能受限的資料類型。

  • 頻道報表和內容擁有者報表文件已經過更新，配合播放位置、流量來源和裝置類型/作業系統報表，更新 redViews 和 estimatedRedMinutesWatched 指標。

2018 年 6 月 18 日

本次更新包含下列 YouTube 數據分析 (目標查詢) API 異動：

  • 下列方法的範圍需求已變更：
    • 對 reports.query 方法發出的要求必須有權存取 https://www.googleapis.com/auth/youtube.readonly 範圍。
    • 向 groupItems.list 方法發出的要求必須有權存取下列其中一項：
      • https://www.googleapis.com/auth/youtube範圍
        或
      • https://www.googleapis.com/auth/youtube.readonly範圍
        和
        https://www.googleapis.com/auth/yt-analytics.readonly 範圍

      第一個選項使用一個範圍，也就是讀取/寫入範圍，第二個選項使用兩個唯讀範圍。

2018 年 5 月 23 日

本次更新包含下列 YouTube 數據分析 (目標查詢) API 異動：

  • API 總覽提供新章節匯總指標和已刪除的項目，說明 API 回應如何處理與已刪除資源 (例如影片、播放清單或頻道) 相關聯的資料。
  • API 總覽的最佳做法一節已更新，提醒您您可以利用 YouTube Data API，擷取 YouTube 數據分析 API 回應中指出的資源的其他中繼資料。根據《YouTube API 服務開發人員政策》(第 III.E.4.b 至 III.E.4.d 節) 所述，API 用戶端必須在 30 天後從該 API 中刪除或更新已儲存的資源中繼資料。

2018 年 5 月 22 日

本次更新包含下列 YouTube Reporting (大量報表) API 相關異動：

  • 下列異動目前預定於 2018 年 7 月生效，新版政策適用於全球各地的所有報表和報表工作。

    • 變更後，大多數 API 報表 (包括候補廣告報表) 都可在報表產生後 60 天內使用，不過，包含歷來資料的報表可保留 30 天 (自報表產生當日起算)。

      在這項公告之前，所有 API 報表都可以在產生後的 180 天內提供。明確來說，在這項政策異動生效後，超過 30 天的歷來資料報表也無法再透過 API 存取。所有其他提供超過 60 天的報表也將無法再繼續提供。因此，說明文件現在指出，在政策異動前建立的報表最長可達 180 天。

    • 做出變更後，當您排定報表工作的時間後，YouTube 將產生自當天起的報表，涵蓋排定工作前 30 天的期間。異動生效前，當你安排報表工作的時間時，YouTube 將產生涵蓋工作排定時間前 180 天的報表。

  • 我們更新了最佳做法章節，提醒您，您可以利用 YouTube Data API 擷取報表內資源的其他中繼資料。根據《YouTube API 服務開發人員政策》(第 III.E.4.b 至 III.E.4.d 節) 所述，API 用戶端必須在 30 天後從該 API 中刪除或更新已儲存的資源中繼資料。

  • 我們更新了「報表特性」一節，提醒您，即使報表資料未經過篩選，如果報表資料的涵蓋時間範圍為 2018 年 6 月 1 日當天或之後，則無法針對在報表產生日期前至少 30 天刪除的 YouTube 資源提供任何參照資料。

  • API 總覽的歷來資料部分已更新，是為了提醒，當您安排新的報表工作時，歷來報表通常會在幾天內發布。根據舊版說明文件，使用者最久可能需要 30 天才能取得這類報表。

  • 更新 API 總覽的「補充資料」部分，將「補充資料」更明確定義為用來取代先前提供的資料集。

2018 年 4 月 26 日

YouTube Analytics (目標查詢) API (v2) 第 2 版現已開放大眾使用。以下列出與新版 API 相關的產品和說明文件變更：

  • 第 2 版 API 與第 1 版 API 幾乎相同。不過，您可能需要更新程式碼，以反映下列變更。我們在新版遷移指南中詳細說明瞭所有異動，

    • API 的版本已從 v1 變更為 v2。
    • API 要求的基準網址已從 https://www.googleapis.com/youtube/analytics/v1 變更為 https://youtubeanalytics.googleapis.com/v2。
    • reports.query 方法的多個參數已更新名稱。具體來說，含有連字號的參數名稱，例如 v1 API 使用駝峰式大小寫的 end-date (endDate)，而非 v2 API 中的連字號。這項變更可讓整個 API 中的參數名稱保持一致，因為 API 的建立及管理群組方法已使用駝峰式大小寫做為參數名稱。
    • v2 API 不支援傳送至 Google 全球 HTTP 批次端點 (www.googleapis.com/batch) 的批次要求。如果您在 v2 API 中傳送批次要求，必須改用端點 https://youtubeanalytics.googleapis.com/v2。

    此外，第 2 版 API 不支援以下幾個第 1 版功能：

    • reports.query 方法不再支援 alt、quotaUser 和 userIp 要求參數。
    • 第 2 版 API 不提供批次端點，可支援由不同 API 發出的要求所構成的批次端點。(然而，批次可能包含對相同 API 不同方法的要求)。Google 即將淘汰所有 API 中的全域批次端點，因此這項淘汰作業不僅適用於 YouTube Analytics API。
    • v2 API 不支援 API v1 中支援的 JSON-RPC 通訊協定。再次提醒您，這項淘汰作業並非僅適用於 YouTube Analytics API。

  • 注意：這是淘汰公告。

    API 第 1 版 (v1) 現已淘汰，將於 2018 年 10 月 31 日以前提供支援。上述日期過後，傳送至第 1 版 API 的所有要求都會停止運作。因此，請務必在 2018 年 10 月 31 日前升級至第 2 版 API，以免無法透過該 API 存取 YouTube 數據分析資料。

2018 年 2 月 21 日

本次更新包含下列 YouTube 數據分析 (目標查詢) API 異動：

  • 觀眾客層報表，根據觀眾年齡層和性別，已停止支援「youtubeProduct」維度，用來識別使用者活動發生在哪個 YouTube 服務。

2018 年 1 月 18 日

這次更新的修改如下：

  • YouTube Reporting API (大量報表)

    • operating_system 維度可用於識別發生觀看的裝置軟體系統，現在支援下列值：
      • 25：KaiOS

  • YouTube Analytics API (指定查詢)

2017 年 12 月 20 日

本次更新包含 YouTube Reporting API 的兩項異動：

  • API 伺服器現在支援對下載報表的要求使用 gzip 壓縮。請注意，其他類型的 API 要求不支援 gzip 壓縮。啟用 gzip 壓縮，可降低每個 API 回應所需的頻寬。而且，雖然應用程式需要額外的 CPU 作業時間才能解壓縮 API 回應，但使用較少的網路資源的好處通常會比該成本高。

    如要接收 gzip 編碼回應，請將 Accept-Encoding HTTP 要求標頭設為 gzip，如以下範例所示：

    Accept-Encoding: gzip

    如要瞭解這項功能，請參閱 API 總覽，以及 report 資源的 downloadUrl 屬性定義。

  • age group 和 gender 維度的說明文件已修正，以便顯示 API 針對這些維度傳回的實際值。請注意，這只是說明文件修正，並不代表 API 功能或行為的變更。具體來說，下列值已變更：

    • age_group 維度值應使用大寫字母、在 AGE 字詞與年齡層中的數字之間包含底線，且須使用底線，而非連字號。因此，age13-17 和 age18-24 等值已分別更正為 AGE_13_17 和 AGE_18_24。
    • gender 維度的值會使用大寫字母。因此，female、male 和 gender_other 值已經修正為 FEMALE、MALE 和 GENDER_OTHER。

2017 年 8 月 10 日

這份說明文件已在 2016 年 8 月 10 日宣布淘汰 YouTube Analytics API 的 earnings 指標。(與此同時，API 也開始支援名為 estimatedRevenue 的新指標，可以提供相同資料)。

由於 earnings 指標屬於核心指標，因此支援自公告日期起一年內有效。不過，該年已結束，因此不再支援「earnings」指標。因此，指定 earnings 指標的 API 要求現在會傳回 400 HTTP 回應代碼。如果您尚未將應用程式更新為使用 estimatedRevenue 指標，而非 earnings 指標，請盡快更新。

API 說明文件已更新，移除其餘 earnings 指標的參照。

2017 年 7 月 6 日

這次更新的修改如下：

  • YouTube Analytics API (指定查詢)

    • API 回應已更新，以反映 API 回應包含截至要求日期範圍內最後一天的資料，該日期範圍已查詢的所有指標皆可供使用。

      例如，如果要求指定的結束日期是 2017 年 7 月 5 日，所有要求指標的值都只會顯示至 2017 年 7 月 3 日，而是納入回應的最後一天。(即使某些要求的指標有 2017 年 7 月 4 日的資料也是如此)。

    • adType 維度現在支援 reservedBumperInstream 值，也就是最長 6 秒的不可略過影片廣告。觀眾必須先觀看影片，才能觀看影片。廣告格式與 auctionBumperInstream 廣告相同，但這個類型是指透過預訂而非競價方式銷售的廣告。

  • YouTube Reporting API (大量報表)

    • ad_type 維度現在支援「20」值，也就是以預訂方式銷售的串場廣告。「串場廣告」這種不可略過的影片廣告最長 6 秒，觀眾可在觀看影片前開始播放，請注意，這個維度的值 19 也是指透過競價 (而非預訂) 銷售的串場廣告。

    • 系統已刪除下列 YouTube Reporting API 報表的報表工作：

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      這些報表類型已於 2016 年 9 月 15 日宣布淘汰，2016 年 12 月 15 日後不再產生這些類型的報表。在此之前產生的報表在產生後的 180 天內仍可存取。因此，部分報表最晚可在 2017 年 6 月 15 日存取。不過，由於報表已經不再提供，您也不需要與該報表相關的工作。

2017 年 5 月 24 日

系統已刪除下列 YouTube Reporting API 報表的所有報表工作：

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

這些報表類型已於 2016 年 6 月 22 日宣布淘汰，2016 年 9 月 22 日後不再產生這些類型的報表。在此之前產生的報表在產生後的 180 天內仍可存取。因此，部分報表最早可回溯至 2017 年 3 月 22 日。不過，由於報表已經不再提供，您也不需要與該報表相關的工作。

2017 年 5 月 22 日

這次更新的修改如下：

  • YouTube Reporting API (大量報表)

    • sharing_service 維度可用於識別用於分享影片的服務，現在支援下列值：

      • 85：YouTube Music
      • 86：YouTube 遊戲
      • 87：YouTube Kids
      • 88：YouTube TV

      此外，在說明文件中，Kakao (Kakao Talk) 的說明已更新用於識別值「52」的名稱，以便與值 73 (Kakao Story) 明確區分。但請放心，這項異動並不能反映與這些服務共用影片的 API 行為或分類變化。

  • YouTube Analytics API (指定查詢)

    • sharingService 維度現在支援下列值：

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

2017 年 3 月 28 日

頻道擁有者如果能在創作者工作室中透過 YouTube 數據分析查看收益資料，現在也能透過 YouTube Analytics API 存取收益資料：

2017 年 3 月 17 日

這次更新的修改如下：

2017 年 3 月 3 日

這次更新的修改如下：

  • YouTube Reporting API (大量報表)

    • date 維度的定義已修正。維度值指的是從太平洋時間上午 12:00 開始，到晚上 11:59 結束的句點。指定日期、月份和年份的太平洋時間。視一年中的時間而定，太平洋時間可以是 UTC-7 或 UTC-8。

      雖然日期通常代表 24 小時，而向前調整的日期則代表 23 小時的時段，而往後調整的日期則代表 25 小時的時段。(在先前的說明文件中，每個日期都表示每個日期皆為不重複的 24 小時制，太平洋時間一律為 UTC-8)。

      請注意，這項修正並不代表實際的 API 行為發生變化。

    • operating_system 維度可用於識別發生觀看的裝置軟體系統，現在支援下列值：
      • 22：Tizen
      • 23：Firefox
      • 24：RealMedia

    • 已刪除「content_owner_basic_a1」報表類型的所有報表工作。該報表類型已於 2016 年 8 月 19 日全面淘汰，但先前產生的 content_owner_basic_a1 報表在產生後的 180 天內仍可使用。因此，部分報表最晚可在 2017 年 2 月 19 日前取得。不過，由於報表已經不再提供，您也不需要與該報表相關的工作。

  • YouTube Analytics API (指定查詢)

    • 與 time periods 相關的維度說明現已修正；維度值是指從太平洋時間上午 12:00 開始，到晚上 11:59 結束的期間。指定日期、月份和年份的太平洋時間。視一年中的時間而定，太平洋時間可以是 UTC-7 或 UTC-8。

      雖然日期通常代表 24 小時，而向前調整的日期則代表 23 小時的時段，而往後調整的日期則代表 25 小時的時段。(先前說明文件指出太平洋時間為 UTC-8，但並未提到某一天可能不代表 24 小時制)。

      請注意，這項修正並不代表實際的 API 行為發生變化。

    • 管道報表說明文件已經更新，指出管道報表目前不含收益或廣告成效指標。因此，https://www.googleapis.com/auth/yt-analytics-monetary.readonly 範圍目前不允許存取管道報表中的金額資料。

    • 「operatingSystem」維度支援三個新的維度值：
      • FIREFOX
      • REALMEDIA
      • TIZEN

2017 年 2 月 8 日

YouTube Analytics API 現在支援選用的 include-historical-channel-data 參數。請注意，只有在擷取內容擁有者報表時，才需要使用這個參數。

透過此參數，內容擁有者可以向 API 回應指出應包含頻道觀看時間和觀看次數資料。預設值為 false，表示 API 回應預設只包含頻道與內容擁有者連結之後的觀看時間和觀看次數資料。

如果 API 要求擷取多個管道的資料，這些規則也適用：

  • 如果參數值為 false，則任何頻道傳回的觀看時間和觀看次數資料，都會以頻道與內容擁有者相連結的日期為準。

    請留意，不同頻道可能在不同日期連結到內容擁有者。如果 API 要求正在擷取多個頻道的資料，且參數值為 false，則 API 回應會根據每個頻道的連結日期列出觀看時間和觀看資料。
  • 如果參數值是 true，回應就會根據 API 要求中指定的開始和結束日期，傳回所有頻道的觀看時間及查看資料。

2016 年 12 月 15 日

我們不再支援下列 YouTube Reporting API 報表，我們已將該報表從說明文件中移除。每份報表已推出新版本。(我們已於 2016 年 9 月 15 日針對這些報告推出淘汰公告)。

API 參考說明文件中的目前報表類型清單也已更新。

2016 年 11 月 11 日

這次更新的修改如下：

    YouTube Reporting API 支援三種全新的片尾報表，以及這些報表的全新維度和指標。這些報表會針對影片停止播放後顯示的結束畫面，提供曝光次數和點閱率統計資料。

    2016 年 11 月 8 日

    本次更新包含下列 YouTube Analytics API 變更：

    • 下列清單中的指標已完全淘汰，不再受到支援。如 2016 年 8 月 10 日的公告所述，系統已經支援參照相同資料的新指標。下表列出已淘汰的指標名稱和新指標名稱：

      已淘汰的指標 新指標
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    2016 年 10 月 27 日

    如果內容擁有者可以存取 YouTube 創作者工作室「報表」專區中的相關報表，YouTube 就會自動產生一組系統管理的廣告收益報表。新的系統管理 API 報表能夠以程式輔助方式提供資料存取權，這些資料也會顯示在可手動下載的創作者工作室報表中。

    系統管理的報表總覽提供新報表的簡介，並說明透過 API 擷取這些報表的程序。這項程序與擷取 YouTube 數據分析大量報表的程序稍有不同，因為合作夥伴不必安排工作即可產生報表。

    更新 reportType 資源的 id 屬性，加入可透過 API 存取的系統管理報表清單：

    • 每部影片的每月全球廣告收益
    • 每部影片的每日廣告收益
    • 每項資產的每月全球廣告收益
    • 每項資產的每日廣告收益 (每國家/地區)
    • 著作權聲明 (不含收益資料)

    2016 年 9 月 27 日

    注意：這是淘汰公告。

    YouTube Analytics API 的「uniques」指標已淘汰。這不是核心指標，在 2016 年 10 月 31 日後會繼續支援。

    2016 年 9 月 15 日

    本次更新包含下列 YouTube Reporting API 異動：

    2016 年 8 月 19 日

    本次更新包含下列 YouTube Reporting API 異動：

    • 「content_owner_basic_a1」報表已完全淘汰，並從說明文件中移除。YouTube 不會再產生該類型的新報表，不過在報表產生後的 180 天內，您仍然可以查看已產生的報表。

      「content_owner_basic_a1」報表取代了 content_owner_basic_a2 報表，詳情請參閱 2016 年 5 月 19 日的修訂版本記錄項目中所述。

    2016 年 8 月 11 日

    這次更新的修改如下：

    • 在新版《YouTube API 服務條款》(以下簡稱「新版條款」) 中，YouTube 工程與開發人員網誌詳細介紹了舊版《服務條款》的一系列更新內容。除了「新版條款」(將於 2017 年 2 月 10 日生效) 外，本次更新也包含多份證明文件，可協助說明開發人員必須遵守的政策。

      如需瞭解完整的新文件，請參閱新版條款修訂版本記錄。此外，日後更新「本條款」或相關佐證文件時，我們也會在修訂版本記錄中說明。您可以訂閱 RSS 動態消息，從文件中的連結列出該修訂版本記錄的變更。

    2016 年 8 月 10 日

    本次更新包含以下異動：

    • YouTube Analytics API (指定查詢)

      • 注意：這是淘汰公告。

        下表中的指標即將淘汰。同時，我們也導入參照相同資料的新指標。換句話說，舊指標重新命名後，YouTube Analytics API 會同時支援這兩種指標名稱，直到表中的淘汰日期為止。

        舊版指標名稱 新指標名稱 支援日期
        earnings estimatedRevenue 2017 年 8 月 10 日
        adEarnings estimatedAdRevenue 2016 年 11 月 4 日
        redPartnerRevenue estimatedRedPartnerRevenue 2016 年 11 月 4 日
        impressionBasedCpm cpm 2016 年 11 月 4 日
        impressions adImpressions 2016 年 11 月 4 日

        請注意，earnings 指標是核心指標，因此提供效期為這則公告當日起算一年後的功能。針對其他非核心指標，系統可提供三個月至 2016 年 11 月 4 日的期間。

        舉例來說，在 2016 年 11 月 4 日之前，API 要求可以指定 impressionBasedCpm 指標和/或 cpm 指標。不過，該日期之後僅支援「cpm」指標。

      • 「insightTrafficSourceType」維度支援兩個新的維度值：
        • CAMPAIGN_CARD：只有內容擁有者報表才支援這項流量來源。這代表觀看次數的來源是已聲明版權的使用者上傳影片，而這些影片是由內容擁有者用於宣傳收看的內容。
        • END_SCREEN：這項資料是來自其他影片片尾的觀看次數。

        您同時可以擷取這兩種新流量來源的 traffic source detail 報表。在這兩種情況下，insightTrafficSourceDetail 尺寸都可用來識別推薦觀眾觀看影片的影片。

      • adType 維度現在支援 auctionBumperInstream 值，也就是最長 6 秒的不可略過影片廣告。觀眾必須先觀看影片，才能觀看影片。

    • YouTube Reporting API (大量報表)

      • traffic_source_type 維度現在支援下列值：
        • 19：只有內容擁有者報表才支援這項流量來源。這代表觀看次數的來源是已聲明版權的使用者上傳影片，而這些影片是由內容擁有者用於宣傳收看的內容。
        • 20：這項資料是來自其他影片片尾的觀看次數。

        兩種新流量來源的「traffic_source_detail」維度會指出是觀眾的來源影片。

      • API 的核心指標清單已修正為核心指標將 estimated_partner_revenue 列為核心指標，並從這份清單中移除 earnings。(YouTube Reporting API 從未支援 earnings 指標)。

      • ad_type 維度現在支援「19」值，亦即串場廣告。這類廣告為不可略過的影片廣告，最長 6 秒，觀眾可在觀看影片前開始播放。

    2016 年 7 月 18 日

    本次更新包含以下異動：

    • YouTube Analytics API (指定查詢)

      • 下列管道報表支援的指標清單已更新，已納入資訊卡指標。我們已於 2016 年 6 月 28 日新增這些報表中的卡片指標支援，而該日期的修訂版本紀錄項目中也會進一步說明異動內容。這些報表如下：
        • 美國各州的基本使用者活動
        • 特定時間範圍內，在美國各州的使用者活動
        • 使用者活動 (依省分組)
        • 使用者活動 (依訂閱狀態區分)
        • 使用者活動 (依州/省的訂閱狀態區分)
        • 各州熱門影片
        • 訂閱頻道或未訂閱觀眾的熱門影片

      • 已修正頻道觀眾續看率報表和內容擁有者觀眾續看率報表的篩選器清單，以反映必須使用「video」篩選器，且不支援「group」篩選器。

        先前這兩份報表的說明文件會誤以為報表擷取的是這兩個篩選器之一，或是兩者皆用。

    • YouTube Reporting API (大量報表)

      • 在「API 總覽」一節中，說明如何擷取報表下載網址的章節已修正，說明 YouTube 會針對無可用資料的日期產生可下載的報表。這些報表包含標題列，但不含其他資料。這項資訊已於 2016 年 4 月 12 日，在同一文件的「報表特性」一節中更新。
      • content_owner_asset_cards_a1 報表中的維度清單已修正，以反映報表使用「card_id」維度。先前說明文件誤將維度名稱列為 card_title。

    2016 年 6 月 28 日

    YouTube 數據分析 API 說明文件已更新，以支援許多頻道和內容擁有者報表中的資訊卡指標。這些新支援的指標如下：

    下列類型的報表支援這些指標：

    2016 年 6 月 22 日

    本次更新包含下列 YouTube Reporting API 異動。對 API 來說，第一種變更大致上適用於 API，其餘變更則只會影響內容擁有者報告：

    • API 總覽的「報表特性」部分已更新，闡明報表可在報表產生後 180 天內透過 API 取得。

      根據先前文件所述，報表可提供的時間範圍最長為 API 要求傳送當天的 180 天前。雖然在技術上來說，原始文字雖然效果最好，但不令人混淆。

    • API 支援三種報表的新版本。其中兩種報表也包含新指標和重新命名後的指標：

      • content_owner_ad_rates_a1 報表是新版 content_owner_ad_performance_a1 報表。新重新命名的報表與先前的版本相同。

      • 有兩份報表已重新命名：

        • 新版 content_owner_estimated_earnings_a1 報表的名稱為 content_owner_estimated_revenue_a1。
        • 新版 content_owner_asset_estimated_earnings_a1 報表的名稱為 content_owner_asset_estimated_revenue_a1。

        這兩份新重新命名的報表都與舊版報表有以下差異：

      請注意，如果您已有工作來建立舊版報表的任何工作，就必須為重新命名的報表建立新工作。隨著新版報表版本推出，content_owner_ad_performance_a1、content_owner_estimated_earnings_a1和content_owner_asset_estimated_earnings_a1報表也一併淘汰。

      如有這類報表的工作，YouTube 不會在 2016 年 9 月 22 日後產生這些工作的新報表。這些報表在產生後的 180 天內仍可使用。

    • 系統已更新 reportType 資源 id 屬性的定義，以反映目前的可用報表組合。

    • 更正說明文件中的兩項指標名稱，確保與報表中顯示的名稱相符。這只是說明文件修正，無法反映實際報表內容的變化：

      • 「estimated_partner_adsense_revenue」指標的名稱已更新為「estimated_partner_ad_sense_revenue」。不過請注意，這項指標只會顯示在本次更新淘汰的兩份報表中。如上所述，在新版報表中，這項指標已重新命名為 estimated_partner_ad_auction_revenue。
      • 「estimated_partner_doubleclick_revenue」指標的名稱已更新為「estimated_partner_double_click_revenue」。另外要注意的是，這項指標只會出現在兩份即將淘汰的報表中。如上所述，在新版報表中，這項指標已重新命名為 estimated_partner_ad_reserved_revenue。

    • Reporting API 的維度說明文件已更新，不再列出 elapsed_video_time_percentage 和 audience_retention_type 屬性。透過 API 取得的任何報表目前都不支援這些維度。

    2016 年 5 月 19 日

    本次更新包含下列 YouTube Reporting API 異動：

    • 這個 API 支援新版內容擁有者使用者活動報告。新報表的報表類型 ID 為 content_owner_basic_a2。與舊版報表 content_owner_basic_a1 不同，新版支援 likes 和 dislikes 指標。

      如果您已經有建立 content_owner_basic_a1 報表的工作，還是需要為 content_owner_basic_a2 報表建立新工作。YouTube 不會自動將內容擁有者遷移至新版報表，也不會自動建立工作來產生新的報表版本。在某些實作項目中，出現非預期的新工作可能是破壞性變更。

      隨著新版報表推出，content_owner_basic_a1 報表已經淘汰。如要使用該報表，YouTube 不會在 2016 年 8 月 19 日後產生該項工作的新報表。這些報表在產生後的 180 天內仍可使用。

    • reportType、job 和 report 資源都支援一種新資源，可指出相關聯的資源是否代表已淘汰的報表類型：

      • reportType 資源的 deprecateTime 屬性可指定報表類型即將淘汰的日期和時間。這個屬性只會針對宣布為已淘汰的報表資料提供值，而這個值代表 YouTube 停止產生該類型報表的日期。

        停止使用報表類型後，YouTube 會在三個月內產生該類型的報表。舉例來說，這項更新將於 2016 年 5 月 19 日宣布淘汰 content_owner_basic_a1 報告。因此，該報表類型的 deprecateTime 指定了 2016 年 8 月 19 日的時間，之後 YouTube 就會停止產生該類型的報表。

      • job 資源的 expireTime 屬性可指定工作的到期日/時間。如果與工作相關的報表類型已不適用，或是系統長時間未下載專為工作產生的報表，就會傳回這個值。該日期代表 YouTube 不再為這項工作產生新報告的時間。

      • report 資源的 jobExpireTime 屬性可指定與報表相關聯的工作日期和時間為過期或將到期。此屬性包含與 job 資源中的 expireTime 屬性相同的值，如這份清單的前一個項目所述。

    • 如果您嘗試為已淘汰的報表建立工作，jobs.create 方法現在會傳回 400 HTTP 回應代碼 (Bad Request)。此外，方法的說明文件現在會列出導致 API 要求失敗的幾個其他原因。

    2016 年 4 月 12 日

    本次更新包含以下變更，這些異動只會影響 YouTube Reporting API：

    • YouTube 現在會產生涵蓋報表工作首次排定報表工作前 180 天的資料。先前 Reporting API 並未提供任何歷來資料。這項變更會影響所有工作，包括在這項公告之前建立的工作。

      歷史報表一有可用就會立即發布，但工作所有歷來資料大約要過一個月才會發布。因此，在排定報表工作後的一個月，您將可存取大約七月的資料。(凡是在這項公告前建立的工作過往資料，應該都會在公告發布後的一個月內發布)。

      請注意，系統只提供 2015 年 7 月 1 日起的歷來資料。因此，2015 年 12 月 28 日前建立的工作，會有不到 180 天的歷來資料。

      Reporting API 總覽的「歷來資料」一節會說明所有異動。

    • YouTube Reporting API 總覽的報表特性一節已更新下列異動：

      • 本文件現在會規定報表產生後 180 天內，因此可供 API 用戶端下載。原本說明文件指出，報表期限最長為 API 請求送出日算起的六個月。

      • 文件內容經過更新，以反映 API 目前產生可下載報表的日期，但這段期間沒有資料。這些報表將包含標題列，但不會包含其他資料。

    • YouTube Reporting API 即將支援一組由系統自動產生的報表，其中包含廣告收益資料或 YouTube Premium 訂閱收益資料。如果內容擁有者已在 YouTube 創作者工作室中查看手動下載的收益報表，因此，新的 API 功能會提供程式以程式輔助的方式存取資料。

      我們即將推出下列 API 變更，為系統管理報表推出做好準備：

      • job 資源的新 systemManaged 屬性會指出資源說明的工作是否會產生系統代管報表。YouTube 會自動為 YouTube 內容擁有者產生由系統管理的報表，內容擁有者無法修改或刪除建立相關報表的工作。

      • jobs.list 方法的新 includeSystemManaged 參數會指出 API 回應是否應包含系統管理報表的工作。這個參數的預設值是 false。

      • jobs.reports.list 方法的新 startTimeAtOrAfter 參數表示 API 回應只會在指定日期當天或之後，才納入報表。同樣地，startTimeBefore 參數表示報表最快資料必須在指定日期之前，API 回應才應包含報表。

        有別於方法的 createdAfter 參數 (與報表建立時間有關)，新的參數與報表中的資料不同。

      • reportType 資源的新 systemManaged 屬性會指出資源是否為系統管理的報表。

      • reportTypes.list 方法的新 includeSystemManaged 參數會指出 API 回應是否應包含系統管理的報表。這個參數的預設值是 false。

    2016 年 3 月 28 日

    YouTube Reporting API 和 YouTube Analytics API 現在可傳回多項其他分享服務的觀看統計資料。

    • 在 YouTube Reporting API 中，「sharing_service」維度支援下列新值：
      • 82：iOS 系統活動對話方塊
      • 83：Google 收件匣
      • 84：Android Messenger
    • 在 YouTube Analytics API 中，「sharingService」維度支援下列新值：
      • ANDROID_MESSENGER：Android Messenger
      • INBOX：Google 收件匣
      • IOS_SYSTEM_ACTIVITY_DIALOG：iOS 系統活動對話方塊

    2016 年 3 月 16 日

    這項更新包含下列變更，對 YouTube Reporting API 和 YouTube Analytics API 都會造成影響：

    YouTube Reporting API

    • 「playback_location_type」維度支援兩個新的維度值：
      • 7：這些是使用者在 YouTube 首頁或主畫面、使用者的「訂閱內容」動態消息，或其他 YouTube 瀏覽功能中發生的觀看次數。
      • 8：這項資料是直接在 YouTube 搜尋結果網頁上獲得的觀看次數。
    • traffic_source_type 維度現在支援以 18 做為維度值。這個值表示影片觀看次數來自列出播放清單中所有影片的網頁。這個來源和來源類型 14 不同，後者代表影片在播放清單中播放時的觀看次數。

    YouTube 數據分析 API

    • 「insightPlaybackLocationType」維度支援兩個新的維度值：
      • BROWSE：這些是使用者在 YouTube 首頁或主畫面、使用者的「訂閱內容」動態消息，或其他 YouTube 瀏覽功能中發生的觀看次數。
      • SEARCH：這項資料是直接在 YouTube 搜尋結果網頁上獲得的觀看次數。
    • insightTrafficSourceType 維度現在支援以 YT_PLAYLIST_PAGE 做為維度值。這個值表示影片觀看次數來自列出播放清單中所有影片的網頁。這個來源與 PLAYLIST 來源類型不同，代表影片在播放清單中播放時的觀看次數。

    2016 年 2 月 8 日

    YouTube Analytics API 支援的指標清單已更新，因此資訊卡指標不再列為該 API 支援的指標。(但上述 API 報表皆未註明為支援任何卡片指標)。

    請注意，您還是可以使用 YouTube Reporting API 擷取資訊卡指標，這個 API 支援許多頻道和內容擁有者報表的這些指標。

    2016 年 1 月 6 日

    YouTube Reporting API 和 YouTube Analytics API 現在都能明確識別透過 Chromecast 裝置產生的觀看次數。

    • 在 YouTube Reporting API 中，operating_system 維度會使用 21 值，識別透過 Chromecast 播放的觀看次數。
    • 在 YouTube Analytics API 中，operatingSystem 維度會使用 CHROMECAST 值，識別透過 Chromecast 發生的觀看次數。

    2015 年 12 月 21 日

    已在說明文件中更新 annotation_clickable_impressions 和 annotation_closable_impressions 指標的名稱，以便與報表傳回的名稱保持一致。這些名稱先前會記錄為 clickable_annotation_impressions 和 closable_annotation_impressions。

    2015 年 12 月 18 日

    根據歐盟 (EU) 法律規定，您必須向歐盟地區使用者揭露特定資訊，並徵得使用者同意。因此，針對歐盟地區的使用者，您必須遵守《歐盟地區使用者同意授權政策》。我們在《YouTube API 服務條款》中已新增這項規定的通知。

    2015 年 12 月 15 日

    這項更新包含下列變更，對 YouTube Analytics API 都會造成影響：

    • YouTube Analytics API 現在支援三種新的播放詳情維度，可用於多種頻道和內容擁有者報表：

      • liveOrOnDemand：這個維度指出報表中的資料是否說明直播期間發生的使用者活動。
      • subscribedStatus：這個維度指出資料中的使用者活動指標，是否與訂閱影片或播放清單頻道的觀眾有關聯。
      • youtubeProduct：這個維度可識別使用者活動發生在哪個 YouTube 資源。可能的值包括核心 YouTube 網站 (或 YouTube 應用程式)、YouTube Gaming 和 YouTube Kids。

      說明文件已更新，可列出適用於頻道和內容擁有者的新播放詳細報表。此外，我們也已經更新許多其他報表，方便您視需求將其中一或多個維度當做維度和/或篩選器使用。

    • 我們調整了說明報表的表格格式，方便您找出可用於擷取每份報表的有效維度、指標和篩選器組合。下表說明「裝置類型」管道報表中會顯示新的格式：

      目錄
      尺寸：
      必填 deviceType
      使用 0 以上 day、liveOrOnDemand、subscribedStatus、youtubeProduct
      指標：
      請使用 1 個以上的值 views、estimatedMinutesWatched
      篩選器：
      請使用 0 或 1 country、州/省、洲別、subContinent
      請使用 0 或 1 video、group
      使用 0 以上 operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

      如要瞭解必填和選填欄位的詞彙說明，請參閱頻道和內容擁有者報告的說明文件。

    • 如果篩選器支援多個值 (video、playlist 和 channel)，YouTube Analytics API 就會自動捨棄 API 使用者無法擷取資料的實體。先前，如果 API 使用者無法存取至少其中一個指定項目的資料，API 伺服器只會傳回錯誤。

      舉例來說，假設使用者提交 API 要求，且 video 篩選器列出 20 個影片 ID，使用者擁有 18 部影片。然而，兩個影片 ID 識別出另一個頻道擁有的影片，另一個 ID 識別出遭刪除的影片，因此不再存在。在這種情況下，API 伺服器現在會捨棄使用者無法存取的兩部影片，且 API 回應包含 API 使用者擁有的 18 部影片的資料，而非傳回錯誤。

    • 如果要求空白的 YouTube 數據分析 group 資料，API 現在會傳回空白的資料集，而非錯誤。

    • 現在，如果您試圖將實體新增至群組，但您沒有該實體的存取權，YouTube Analytics API 的 groupItems.insert 方法就會傳回未經授權的 (403 HTTP 回應代碼) 錯誤。過去，API 可以讓您將實體新增至群組，但之後當您嘗試擷取該群組的報表資料時，傳回了未經授權的錯誤。

    • YouTube Analytics API 的 groups.list 方法現在支援分頁。如果 API 回應未包含所有可用的群組，則回應的 nextPageToken 參數會指定用於擷取下一個結果頁面的符記。將方法的 pageToken 參數設為該值，即可擷取其他結果。

    2015 年 11 月 10 日

    這次更新的修改如下：

    2015 年 10 月 29 日

    這次更新的修改如下：

    • YouTube Reporting API date 維度的說明文件已修正，反映的顯示日期從太平洋時間凌晨 12:00 (UTC-8) 開始的 24 小時期間。先前說明文件指出日期始於凌晨 12 點 (格林威治標準時間)。

      此外，YouTube Analytics API 說明文件已更新，現在所有日期相關維度 (day、7DayTotals、30DayTotals 和 month) 都是指太平洋時間凌晨 12:00 (UTC-8) 的日期。

    • YouTube Reporting API 的 jobs.reports.list() 方法現在支援 createdAfter 查詢參數。如有指定，此參數表示 API 回應只會列出在指定日期和時間之後建立的報表，包括具有補充資料的新報表。請注意，參數值涉及報表的建立時間，而不是與傳回資料相關聯的日期。

      參數值是 RFC3339 世界標準時間「Zulu」的時間戳記格式，精確到微秒。範例："2015-10-02T15:01:23.045678Z"。

      我們也更新了 YouTube Reporting API 最佳做法，說明如何使用 createdAfter 參數避免重複處理相同的報表。

    • job 資源 createTime 屬性的定義以及 report 資源的 startTime、endTime 和 createTime 屬性定義皆已修正，因此屬性值準確為微秒，而非奈秒。此外，所有定義現在都準確反映屬性值是時間戳記。

    2015 年 10 月 8 日

    這次更新的修改如下：

    • YouTube Analytics API「sharingService」維度的說明文件已更新，納入可能的維度值清單。此清單列出幾項最新支援的服務。

      此外，YouTube Reporting API 的「sharing_service」維度定義也已更新，以列出新支援的值。列舉值大於 59 是清單中新的值。

    2015 年 9 月 24 日

    這次更新的修改如下：

    • 新的 YouTube Reporting API 可擷取大量資料報表，內含頻道或內容擁有者的 YouTube 數據分析資料。這項服務專為能匯入大型資料集的應用程式所設計，並提供可篩選、排序及挖掘資料的工具。

      每一份 YouTube Reporting API 報表都包含一組預先定義的維度和指標。(YouTube Analytics API 報表也會使用指標和維度)。在報表中，每一列的資料都各有一組不重複的維度值。您可以根據維度值匯總資料列的資料，計算個別影片、國家/地區、直播影片、訂閱使用者等指標。

      您可以使用這個 API 排定報表工作，每個工作都能識別 YouTube 應該產生的報表。設定工作後，YouTube 會產生可非同步下載的每日報表。每份報表都包含不重複 24 小時的資料。

    • 雖然 API 是不同的 API，但 YouTube Analytics API 和 YouTube Reporting API 都能讓開發人員擷取 YouTube 數據分析資料。由於兩個 API 都開放存取類似的資料集，因此這兩個 API 的說明文件將以一組文件的形式發布。

      • 說明文件集中的「指南」分頁包含這兩個 API 通用的資訊，包括授權 API 要求的操作說明。
      • 「大量報表」分頁包含 YouTube Reporting API 專屬的參考說明文件和其他內容。
      • 「指定查詢」分頁包含 YouTube Analytics API 專用的參考說明文件和其他內容。
      • 「範例」分頁列出這兩種 API 的任一可用程式碼範例。
      • 「工具」分頁列出了可協助開發人員導入這兩種 API 的其他資源。

    2015 年 8 月 20 日

    這次更新的修改如下：

    • 為了讓 API 更易於理解，我們調整了 API 說明文件。因此，這些變更並非描述新功能：

      • 說明文件現在包含單一頁面，當中會列出所有可用的頻道報表，另一個頁面則列出所有可用的內容擁有者報表。以往，這份文件分別為頻道影片報表、頻道播放清單報表等頁面。

      • 新的資料模型總覽以便更清楚瞭解 API 的運作方式。具體來說，本文將進一步說明 YouTube 如何使用指標、維度和篩選器來計算報表值。

      • 現在您可以分別記錄 API 的 reports.query 方法 (可用來擷取報表)。該網頁先前有其他網頁的資訊。新版頁面將協助您更輕鬆地識別報表擷取所需的資訊。

    2015 年 7 月 22 日

    這項更新包含幾項變更，所有變更僅適用於內容擁有者：

    • 新的「adEarnings」指標會包含 Google 銷售的所有廣告來源預估總收益 (淨收益)。這不是核心指標。針對任何支援 earnings 指標的報表，這個 API 支援「adEarnings」指標。

      此外，「earnings」指標的定義也已修正，以反映 Google 銷售及非廣告來源帶來的預估收益總和。先前，定義指出指標只納入廣告來源的收益。

    • 「primaryAdGrossRevenue」指標已淘汰。請改用 grossRevenue 指標擷取收益資料。

    • 除了已淘汰的 primaryAdGrossRevenue 指標外，廣告成效報表也不再支援 monetizedPlaybacks 和 playbackBasedCpm 指標。不過，部分影片報表仍支援這些指標。

    2015 年 6 月 1 日

    這次更新的修改如下：

    • 這個 API 現在支援影片報表有兩個新指標：videosAddedToPlaylists 和 videosRemovedFromPlaylists。頻道和內容擁有者的影片報表清單已更新，現已有支援新指標的報表。

      • videosAddedToPlaylists：查詢範圍內影片加入 YouTube 播放清單的次數。影片可能已新增至影片擁有者的播放清單或其他頻道播放清單
      • videosRemovedFromPlaylists：查詢範圍內的影片從任何 YouTube 播放清單移除的次數。影片可能已從影片擁有者的播放清單或其他頻道中移除播放清單

      這兩項指標都含有預設播放清單 (例如「稍後觀看」)播放清單但不會計入自動新增影片的播放清單，例如頻道的上傳內容播放清單或使用者的觀看記錄。另外也請注意，這些指標反映的是新增和刪除次數的絕對值。因此，如果使用者將影片新增至播放清單，隨後在移除後再次加入該影片，則指標會指出影片從兩個播放清單中移除後，從一個播放清單中移除。

      這些指標的資料可自 2014 年 10 月 1 日起提供。

    2015 年 3 月 31 日

    這次更新的修改如下：

    2015 年 3 月 16 日

    這次更新的修改如下：

    • 新的 currency 參數可讓您以美元 (USD) 以外的貨幣擷取收益指標。設定這個參數後，API 就會將 earnings、grossRevenue、playbackBasedCpm 和 impressionBasedCpm 指標的值轉換為指定貨幣。傳回的值是根據每日變動的匯率計算而得。

      參數值為三字母 ISO 4217 貨幣代碼。預設值為 USD。參數定義包含支援的貨幣代碼清單。

    2015 年 2 月 25 日

    這次更新的修改如下：

    • 這個 API 現在支援建立及管理 YouTube 數據分析群組，以及擷取這些群組的報表資料。

      • 建立及管理群組

        本次更新推出了用於建立及管理群組的 group 和 groupItem 資源。

        • group 資源代表 Analytics 群組，以及最多 200 個頻道、影片、播放清單或資產的自訂集合。API 支援這項資源的 list、insert、update 和 delete 方法。
        • groupItem 資源代表 Analytics 群組中的項目。API 支援這項資源的 list、insert 和 delete 方法。

        舉例來說，您可以使用 groups.insert 方法建立群組，然後使用 groupItems.insert 方法將項目新增至該群組。

      • 擷取群組的報表資料

        維度說明文件已經更新，加入「group」維度，可做為許多頻道報表和內容擁有者報表的篩選器。使用 group 篩選器時，API 會傳回該群組中所有項目的資料。請注意，這個 API 目前不支援建立素材資源群組報表的功能。

      如要進一步瞭解 YouTube 數據分析群組，請參閱 YouTube 說明中心。

    2015 年 2 月 13 日

    這次更新的修改如下：

    • API 不再支援 show 維度。

    2014 年 8 月 28 日

    這次更新的修改如下：

    • 當 video、playlist、channel 和 show 維度用這些維度做為篩選器時，API 現在支援指定多個值。如要指定多個值，請將 filters 參數值設為以逗號分隔的影片、播放清單、頻道清單，或顯示應篩選 API 回應的 ID。參數值最多可指定 200 個 ID。

      如果您為同一個篩選器指定多個值，也可以將該篩選器加進您為請求指定的維度清單中。即使該篩選器未列為特定報表支援的維度，也是如此。如果您將篩選器加入維度清單，API 也會使用該篩選器的值將結果分組。

      如需這項功能的完整詳細資料，請參閱 filters 參數定義。

    2014 年 7 月 16 日

    這次更新的修改如下：

    • 現在擷取管道報表時，只要將 ids 參數的值設為 channel==MINE，即可擷取已驗證使用者頻道的資料。(您也可以將 ids 參數設為 channel==CHANNEL_ID，擷取指定管道的資料)。

    • API 現在支援播放清單報表，其中包括與播放清單內影片觀看次數相關的統計資料。頻道和內容擁有者都可以使用播放清單報表。

      所有播放清單報表都支援 views 和 estimatedMinutesWatched 指標，部分報表也支援 averageViewDuration 指標。

      此外，所有播放清單報表都支援下列新指標。請注意，每項指標都只反映網路上的播放清單觀看次數。

      凡是擷取播放清單報表的要求，都必須使用 isCurated 篩選器，此篩選條件應設為 1 (isCurated==1)。

    • 這個 API 現已支援「觀眾續看率」報表。這份報表會評估影片留住觀眾的能力。報表新的「elapsedVideoTimeRatio」維度會測量相應指標值已播放的影片數量：

      • audienceWatchRatio 指標可指出影片在特定時間點觀看內容的觀眾比例。比例的計算方式是比較特定影片部分的觀看次數與影片總觀看次數。

        請注意，在同一部影片中，部分影片可能會重複觀看，或是完全不觀看。舉例來說，如果使用者倒轉影片，並多次觀看相同片段，則該片段的絕對比率可能會大於 1。

      • 「relativeRetentionPerformance」指標會顯示影片在播放期間，與所有片長相近的 YouTube 影片相比，觀眾在播放期間的續看率。0 表示影片的續看率低於任何其他長度相近的影片，值 1 表示影片的續看率高於任何其他長度相近的影片。中位數值為 0.5，代表長度相近的影片有一半能留住觀眾，一半的續看率則較低。

      您也可以使用 audienceType 篩選器，讓報表只傳回與自然觀看次數、TrueView 串流內廣告的觀看次數，或 TrueView 多媒體廣告觀看次數相關的資料。(自然觀看次數是指使用者採取動作 (例如搜尋影片或點選推薦影片) 所產生的直接觀看次數。

    • API 支援數個與註解相關的新指標。凡是先前支援 annotationClickThroughRate 和 annotationCloseRate 指標的報表，都可以擷取下列指標。

      所有新指標都是核心指標，且適用於《廢止政策》的規定。但請注意，系統可提供新指標截至 2013 年 7 月 16 日的資料。(系統提供 annotationClickThroughRate 和 annotationCloseRate 指標截至 2012 年 6 月 10 日的資料)。

    • 「GOOGLE_SEARCH」不再顯示為insightTrafficSourceType維度的個別值。而是將 Google 搜尋結果的參照連結網址歸因於 EXT_URL 流量來源類型。因此，你無法再擷取將 insightTrafficSourceType 篩選器設為 GOOGLE_SEARCH 的 insightTrafficSourceDetail 報表。

    2014 年 1 月 31 日

    這次更新的修改如下：

    2014 年 1 月 16 日

    這次更新的修改如下：

    • 要求範例文件已經過重新設計，將範例分門別類，使用類似於頻道和內容擁有者最近發布的分頁格式。採用新版設計的範例將分成以下類別：

      • 基本數據
      • 根據時間
      • 地理區域
      • 播放位置
      • 流量來源
      • 裝置/作業系統
      • 客層
      • 社群媒體
      • 收益/廣告 (僅限內容擁有者報表)

    • 要求範例文件現在提供新的範例，說明如何從頻道報表或內容擁有者報表中擷取州/省專屬資料。

      • 美國各州和華盛頓特區的各州專屬指標：這份報表會擷取頻道中影片的觀看次數 (按州/省劃分) 及其他統計資料。資料涵蓋美國各州與華盛頓特區。本範例使用 province 維度，並使用 filters 參數將回應限制為只包含美國的結果。

      • 加州的觀眾受眾特徵 (年齡層和性別)：這份報表會擷取加州觀眾 (看過頻道影片的觀眾) 的年齡層和性別統計資料 (如內容擁有者檢舉的已聲明著作權內容)。這個範例使用 filters 參數，確保回應只包含特定省份的資料。

    • province 維度的定義已更新，請注意，當 dimensions 參數值包含 province 時，該要求也必須將 country==US 納入 filters 參數值中，才能將資料限制在美國。

    2014 年 1 月 6 日

    這次更新的修改如下：

    • 我們重新設計了列出支援頻道和內容擁有者報告的文件。與其提供列出所有可用報表的表格，每份文件都會改為將報表分組：

      • 基本數據
      • 根據時間
      • 地理區域
      • 播放位置
      • 流量來源
      • 裝置/作業系統
      • 客層
      • 社群媒體
      • 熱門影片

      每份文件都會以分頁清單的形式顯示這些類別。點選任一分頁標籤，即可查看該類別支援的報表。

    • API 現在支援三個新的地理區域維度：province、continent 和 subContinent。

      • province 維度可讓您擷取美國各州和哥倫比亞特區的統計資料。API 支援此維度的兩種用途：

        • 這個 API 支援兩份報表，可根據各州細分統計資料。頻道和內容擁有者都能使用這兩種報表。

          • 核心統計資料報告提供多項統計資料，包括觀看次數和估計觀看時間 (分鐘)。
          • 時間報告提供相同的統計資料，但是會以每日、7 天、30 天或每月來匯總資料。

        • 您可以使用 filters 查詢參數，限制報表只納入特定狀態的統計資料。有些報表支援這類篩選功能，包括地理區域報表、播放位置報表、流量來源報表、裝置報表、作業系統報表、客層報表和熱門影片報表。

      • continent 維度會指定聯合國 (UN) 統計資料區碼，用於識別該洲。這項維度只能做為篩選器使用。

      • 「subContinent」維度會指定聯合國 (UN) 統計資料區碼，用於識別某大洲的子區域。這項維度只能當做篩選條件使用。

        由於每個子區域只與一個洲別建立關聯，因此使用 subContinent 篩選器時，不需要另外使用 continent 篩選器。(實際上，如果請求同時使用兩個維度，API 會傳回錯誤)。

    • 說明文件已修正，因此 insightTrafficSourceDetail 維度不包含 insightTrafficSourceType 值 PROMOTED 做為有效的篩選器值。

    2013 年 9 月 30 日

    這次更新的修改如下：

    • 現在 YouTube Analytics API 會受到《服務條款》中所述的《廢止政策》約束。不過，這個 API 的非核心維度及非核心指標則不受廢止政策約束。維度和指標頁面已更新，列出核心維度和指標。此外，我們也更新了這些網頁上的定義，以明確標示核心維度和指標。

    • API 現在支援 EXTERNAL_APP 做為 insightPlaybackLocationType 維度的值。配合這項更新，自 2013 年 9 月 10 日起，播放次數不再歸為 MOBILE 播放次數，但在該日期前透過行動裝置播放的影片仍會計入這個值。

      本次更新後，行動裝置播放次數現已歸類為 WATCH、EMBEDDED 或 EXTERNAL_APP，具體取決於發生播放的應用程式類型。

    • API 現在支援 PLAYLIST 做為 insightTrafficSourceType 維度的值。這個值代表影片觀看次數源自播放清單。這些資料檢視先前會使用維度的「YT_OTHER_PAGE」類別進行分類。

    2013 年 7 月 16 日

    這次更新的修改如下：

    • API 現在支援依多個維度和指標排序報表。要求範例文件內含「按多個維度/指標排序請求」這個新範例，示範這項功能。該要求會擷取流量來源資料，且 sort 參數值為 day,-views。結果會按時間順序排序，但在每天的結果集中，第一列包含觀看次數最多的流量來源資料，第二列包含觀看次數排名次高的來源的資料，以此類推。

    • 這個 API 現在支援 deviceType 和 operatingSystem 兩種新維度，可用於擷取觀眾觀看影片的裝置相關資料。這個 API 支援使用一或多個維度的報表。

      • deviceType報表可讓您擷取各種裝置 (包括電腦、行動裝置和平板電腦) 的觀看次數和預估觀看時間。您也可以使用 operatingSystem 篩選器，限制裝置類型報表只列出執行特定作業系統裝置 (例如 Android 或 iOS) 的統計資料。

      • operatingSystem 報表可讓您擷取不同作業系統 (例如 Android、iOS、Linux 等) 的觀看次數和預估觀看時間。您也可以使用 deviceType 篩選器，限製作業系統報表只包含特定裝置類型 (例如行動裝置或平板電腦) 的統計資料。

      新版裝置類型和作業系統報表適用於頻道和內容擁有者。

    • 請求範例文件已更新，現在加入三種頻道適用的裝置報告，以及三份內容擁有者適用的裝置報告。

    • insightPlaybackLocationType 維度可能會傳回 YT_OTHER 值，以識別未使用任何維度其他值分類的瀏覽。

    2013 年 5 月 23 日

    這次更新的修改如下：

    • 內容擁有者報表文件已更新，依照收益遞減排序熱門影片報表，找出收益最高的影片。這份報表是「使用者活動與收益報表」部分第二表格中列出的第一份。

    2013 年 5 月 10 日

    這次更新的修改如下：

    2013 年 5 月 6 日

    這次更新的修改如下：

    • 這個 API 現在支援擷取觀看時間指標 (estimatedMinutesWatched、averageViewDuration和 averageViewPercentage) 與其他指標，包括觀看指標、參與度指標、收益指標和廣告成效指標。

      我們更新了可用的頻道報表和內容擁有者報表清單，以反映這項異動。(由於觀看時間指標可當做其他報表的一部分來擷取，因此清單上已有較短的時間)。

      範例 API 要求文件也已更新。

    • 系統已透過下列方式強化使用 insightPlaybackLocationDetail 和 insightTrafficSourceDetail 維度的報表：

      • 支援選用 country 篩選器。

      • 內容擁有者現在可以使用下列任何新的 filter 組合擷取這些報表。請注意，這些組合都支援選用的 country 篩選器。

        • 播放位置詳細資料

          • channel,insightPlaybackLocationType==EMBEDDED
          • show,insightPlaybackLocationType==EMBEDDED
          • claimedStatus,insightPlaybackLocationType==EMBEDDED
          • uploaderType,insightPlaybackLocationType==EMBEDDED
          • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

        • 流量來源詳細資料

          • channel,insightTrafficSourceType
          • show,insightTrafficSourceType
          • claimedStatus,insightTrafficSourceType
          • uploaderType,insightTrafficSourceType
          • uploaderType,claimedStatus,insightTrafficSourceType

    2013 年 5 月 3 日

    這次更新的修改如下：

    • 新版 Sample API 要求文件提供多個範例，示範如何使用 YouTube Analytics API 擷取多種不同類型的報表。每個範例都對請求擷取的報表提供簡短說明，然後顯示請求的維度、指標、篩選器和排序參數。

    • insightTrafficSourceType 維度現在支援 SUBSCRIBER 做為有效值。這個值可識別影片觀看次數，來源是 YouTube 首頁的動態消息或 YouTube 訂閱功能。如果你根據這個流量來源進行篩選，insightTrafficSourceDetail 欄位會指定首頁動態饋給或其他參照觀看來源的網頁。

    2013 年 3 月 28 日

    這次更新的修改如下：

    2013 年 3 月 21 日

    這次更新的修改如下：

    • 這個 API 現在支援收益與廣告成效指標，以及全新的廣告成效報表。只有已加入 YouTube 合作夥伴計畫的 YouTube 內容合作夥伴才能查看這些指標和報表。

      • 全新的報表支援以播放次數為依據的廣告成效指標和以曝光為基礎的廣告成效指標。如要進一步瞭解廣告成效報表，請參閱內容擁有者報表說明文件。

      • 以下列出最新支援的指標。內容擁有者報表清單已更新，現在能以更簡單的方式識別支援這些指標的報表，其中包含兩種新報表。

        • earnings - 所有 Google 銷售的廣告來源帶來的預估總收益。
        • grossRevenue - Google 或 DoubleClick 合作夥伴的預估總收益。
        • primaryAdGrossRevenue - 報表涵蓋的影片播放次數 (來自 Google 或 DoubleClick 合作夥伴) 的預估總收益 (已加總或歸類為主要廣告類型)。
        • monetizedPlaybacks - 出現至少一次廣告曝光的播放次數。
        • playbackBasedCpm - 每播放一千次的預估總收益。
        • impressions - 已放送已驗證廣告曝光的次數。
        • impressionBasedCpm - 每千次曝光的預估總收益。

        注意：如需完整詳情，請參閱指標定義。

      • 凡是擷取收益或廣告成效指標的要求，都必須傳送授權權杖，使用新的 https://www.googleapis.com/auth/yt-analytics-monetary.readonly 範圍授予存取權。

    • API 說明文件經過重新編排，以便分別在不同的頁面中說明不同類型的報表。因此，現在有不同頁面，分別說明不同類型的頻道報表和內容擁有者報表。

    2013 年 2 月 4 日

    這次更新的修改如下：

    • API 的參考指南現已推出範例一節，內含使用 Java、JavaScript、Python 和 Ruby 用戶端程式庫呼叫 API 的程式碼範例。JavaScript 程式碼範例與範例應用程式說明文件中詳述的相同。

    2012 年 11 月 14 日

    這次更新的修改如下：

    • API 參考指南現在提供 APIs Explorer，方便您呼叫 API、查看 API 要求，以及擷取回應中的實際資料。

    • 這個 API 支援頻道和內容擁有者的各種新報表，詳情請見下文。每份報表都可下載為頻道報表或內容擁有者報表。維度和指標頁面也一併更新了。

      • 播放位置報表可指出不同類型網頁或應用程式的影片觀看次數。

      • 播放位置詳細報表可指出為指定影片帶來最多觀看次數的內嵌播放器。相較於播放位置報表，這個報表能找出熱門嵌入式播放器的相關網址，讓您更加瞭解播放進度。

      • 流量來源報表可識別源自不同參照網址類型的影片觀看次數。

      • 「流量來源詳細資料」報表會找出為指定影片及指定流量來源類型帶來最多觀看次數的參照網址，舉例來說，這份報表會顯示為特定影片帶來最多流量的相關影片。這份報表支援多個流量來源。

      • 觀看時間報表會顯示觀眾花多少時間觀看你的內容。報表中可以彙整特定時間範圍 (日、前 7 天、過去 30 天等) 或國家/地區的資料。如果報表彙整日期或國家/地區的資料，還可以指明每次影片觀看的平均長度，以及使用者觀看影片的平均百分比。

    2012 年 10 月 2 日

    這次更新的修改如下：

    • YouTube Analytics API 現已開放所有開發人員使用。您可以透過 APIs console 中的「服務」面板，為專案啟用 API，無須先提出存取權要求。

    • 新的「開始使用」一節將概略說明建構使用 YouTube Analytics API 的應用程式的必要條件和基本步驟。

    2012 年 9 月 12 日

    這次更新的修改如下：

    • 新的「瞭解配額用量」一節提供如何最佳化 API 配額用量的指南。API 伺服器會計算各項要求的查詢費用，從您的 API 使用配額中扣除相關費用。由於各類報表的查詢成本可能大不相同，您應該以有效率的方式運用配額，而且應用程式應該只要求實際所需的指標和資料。

    • 我們更新了暫時維度部分，說明這些維度代表 Analytics 報表應根據時間範圍匯總資料。API 現在支援下列其他時間維度：

      • 7DayTotals - 報表中的資料會經過匯總，讓每個資料列包含七天的資料。
      • 30DayTotals - 報表中的資料會經過匯總，讓每一列都含有 30 天的資料。
      • month – 報表中的資料會按月份匯總。

      此外，可用的報表部分也已更新，以反映 API 對使用這些維度的報表相關支援。

    • 報表實體維度一節已更新，請注意 API 擷取內容擁有者報表的 API 要求，必須使用其中一個維度 (video、channel 或 show) 或是支援的 claimedStatus 和 uploaderType 維度組合篩選資料。

    • API 現在支援兩個熱門影片報表的新排序選項。這類報表適用於頻道報表或內容擁有者報表，內含觀看次數、留言數和喜歡人數等以國家/地區為依據的指標，並依影片細分這些指標。您現在可以根據在影片觀賞頁面中訂閱或取消訂閱頻道的使用者人數來排序報表。

    • 我們更新了 subscribersGained 和 subscribersLost 指標的定義，解釋頻道的訂閱人數在各處可能有所增減，包括影片觀賞頁面、頻道頁面，以及 YouTube 首頁顯示的指南。在影片專屬報表中，這些指標只會納入指定影片觀賞頁面的統計資料。